次の方法で共有


ControlDesigner.GetEmptyDesignTimeHtml メソッド

定義

実行時には視覚的な表示がない Web サーバー コントロールをデザイン時に表すための HTML マークアップを取得します。

protected:
 virtual System::String ^ GetEmptyDesignTimeHtml();
protected virtual string GetEmptyDesignTimeHtml ();
abstract member GetEmptyDesignTimeHtml : unit -> string
override this.GetEmptyDesignTimeHtml : unit -> string
Protected Overridable Function GetEmptyDesignTimeHtml () As String

戻り値

他に視覚的に表示する方法がないコントロールをデザイン時に表すために使用する HTML マークアップ。 既定では、コンポーネントの種類と ID を含んでいる四角形が表示されます。

次のコード例では、カスタム コントロール デザイナーで メソッドを GetDesignTimeHtml オーバーライドする方法を示します。 関連付けられたコントロールの Text プロパティが空の場合、メソッドは メソッドを GetDesignTimeHtml 呼び出します GetEmptyDesignTimeHtml 。 それ以外の場合、メソッドは GetDesignTimeHtml コントロールを Hyperlink 作成してレンダリングします。

public override string GetDesignTimeHtml()
{
    if (simpleControl.Text.Length > 0)
    {
        string spec = "<a href='{0}.aspx'>{0}</a>";
        return String.Format(spec, simpleControl.Text);
    }
    else
    {
        return GetEmptyDesignTimeHtml();
    }
}
Public Overrides Function GetDesignTimeHtml() As String
   ' Component is the instance of the component or control that
   ' this designer object is associated with. This property is 
   ' inherited from System.ComponentModel.ComponentDesigner.
   simpleControl = CType(Component, Simple)
   
   If simpleControl.Text.Length > 0 Then
      Dim sw As New StringWriter()
      Dim tw As New HtmlTextWriter(sw)
      
      Dim placeholderLink As New HyperLink()
      
      ' Put simpleControl.Text into the link's Text.
      placeholderLink.Text = simpleControl.Text
      placeholderLink.NavigateUrl = simpleControl.Text
      placeholderLink.RenderControl(tw)
      
      Return sw.ToString()
   Else
      Return GetEmptyDesignTimeHtml()
   End If
End Function

注釈

メソッドの既定の GetEmptyDesignTimeHtml 動作では、コンポーネントの名前を含む文字列を返します。 GetEmptyDesignTimeHtmlデザイン時の HTML マークアップがない場合は、 GetDesignTimeHtml メソッドの実装で メソッドを呼び出す必要があります。

適用対象

こちらもご覧ください