ControlDesigner.GetEmptyDesignTimeHtml メソッド

.NET Framework クラス ライブラリ リファレンス

ControlDesigner.GetEmptyDesignTimeHtml メソッド

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

名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Function
 GetEmptyDesignTimeHtml As String

Visual Basic (使用法)

Dim returnValue As String

returnValue = Me.GetEmptyDesignTimeHtml

C#

protected virtual string GetEmptyDesignTimeHtml
 ()

C++

protected:
virtual String^ GetEmptyDesignTimeHtml ()

J#

protected String GetEmptyDesignTimeHtml ()

JScript

protected function GetEmptyDesignTimeHtml ()
 : String

戻り値
他にビジュアルな表示が存在しないコントロールをデザイン時に表すために使用する HTML マークアップ。既定値は、コンポーネントの種類と ID を含んでいる四角形です。

解説

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

使用例

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

Visual Basic

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

C#

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();
}

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ControlDesigner クラス
ControlDesigner メンバ
System.Web.UI.Design 名前空間
GetErrorDesignTimeHtml
GetDesignTimeHtml
その他の技術情報
Web フォームのデザイン時サポート