次の方法で共有

TextControlDesigner.GetDesignTimeHtml メソッド

  • [アーティクル]

デザイン時に関連付けられたコントロールを表すために使用する HTML を取得します。

Overrides Public Function GetDesignTimeHtml() As String
[C#]
public override string GetDesignTimeHtml();
[C++]
public: String* GetDesignTimeHtml();
[JScript]
public override function GetDesignTimeHtml() : String;

戻り値

デザイン時にコントロールを表すために使用する HTML。

解説

TextControlDesigner クラスは、 ControlDesigner.GetDesignTimeHtml メソッドをオーバーライドして、コントロールをデザイン画面に表示するときに、空ではない Text プロパティが存在するようにします。これにより、デザイン時のコントロールの表現が意味あるものとなるようにします。このメソッドは、コントロールの任意の空の Text プロパティを、コントロールの ID プロパティに設定します。

使用例

[Visual Basic] LinkButtonDesigner クラスから派生した CustomLinkButtonDesigner カスタム デザイナ クラスを作成する方法のコード例を次に示します。この例は、 GetDesignTimeHtml メソッドをオーバーライドします。このメソッドは、 LinkButtonDesigner クラスが TextControlDesigner クラスから継承したものです。 LinkButton.Text プロパティが設定済みでない場合は、このメソッドを呼び出すと、プロパティに文字列が設定され、デザイン画面にその文字列が表示されます。 LinkButton.Text プロパティが設定されている場合は、既存のプロパティ値が表示されます。

 
' Create a class that derives from LinkButtonDesigner
' that displays the custom SampleLinkButton control
' on a design surface.
Imports System
Imports System.Design
Imports System.Drawing
Imports System.ComponentModel
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports Examples.AspNet

Namespace Examples.AspNet.Design

 <System.Security.Permissions.SecurityPermission( _
   System.Security.Permissions.SecurityAction.Demand, _
    Flags:=System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)> _
Public Class SampleLinkButtonDesigner
   Inherits LinkButtonDesigner
   
 
   ' Override the GetDesignTimeHtml method.
   Public Overrides Function GetDesignTimeHtml() As String

      Dim sampleButton As SampleLinkButton = CType(Component, SampleLinkButton)
      Dim designTimeHtml As String = Nothing      
      
      ' Check the control's BorderStyle property
      ' to conditionally render design-time HTML.
      If (Color.op_Equality(sampleButton.ForeColor, Color.Empty)) Then

          ' Create a variable to hold current property settings.
          Dim oldForeColor As Color = sampleButton.ForeColor
                    
          ' Set properties and the design-time HTML.
          Try
              sampleButton.ForeColor = Color.DarkGreen
              designTimeHtml = MyBase.GetDesignTimeHtml()
                
          ' If an exception occurs, call the GetErrorDesignTimeHtml
          ' method.
          Catch ex As Exception
              designTimeHtml = GetErrorDesignTimeHtml(ex)

          ' Return properties to their original settings.
          Finally
              sampleButton.ForeColor = oldForeColor
          End Try
          
      Else
          designTimeHtml = MyBase.GetDesignTimeHtml()
      End If
      
      Return designTimeHTML

   End Function   
   
  End Class 
End Namespace

[C#, C++, JScript] C#、C++、および JScript のサンプルはありません。Visual Basic のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

TextControlDesigner クラス | TextControlDesigner メンバ | System.Web.UI.Design 名前空間