次の方法で共有

ButtonDesigner.GetDesignTimeHtml メソッド

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

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

戻り値

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

解説

Text プロパティが空の場合、 ButtonDesigner クラスの GetDesignTimeHtml メソッドは、コントロールの Text プロパティをそのコントロールの ID プロパティに設定します。ただし、オーバーライドされた場合は例外です。

使用例

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

 
' Create a class that derives from ButtonDesigner
' that displays the custom SampleButton control
' on a design surface.
Imports System
Imports System.Design
Imports System.Drawing
Imports System.ComponentModel
Imports System.Diagnostics
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 SampleButtonDesigner
   Inherits ButtonDesigner
   
 
   ' Override the GetDesignTimeHtml method.
   Public Overrides Function GetDesignTimeHtml() As String

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

          ' Create variables to hold current property settings.
          Dim oldBorderStyle As BorderStyle = sampleButton.BorderStyle
          Dim oldBorderWidth As Unit = sampleButton.BorderWidth
          Dim oldBorderColor As Color = sampleButton.BorderColor
                    
          ' Set properties and the design-time HTML.
          Try
              sampleButton.BorderStyle = BorderStyle.Dashed
              sampleButton.BorderWidth = Unit.Pixel(3)
              sampleButton.BorderColor = Color.Blue
              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.BorderStyle = oldBorderStyle
              sampleButton.BorderWidth = oldBorderWidth
              sampleButton.BorderColor = oldBorderColor
          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 セキュリティ:

参照

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

  • Last updated on