CheckBoxDesigner.GetDesignTimeHtml 方法

定義

命名空間:

System.Web.UI.Design.WebControls

組件:

System.Design.dll

取得用來在設計階段表示控制項的標記。

public:
 override System::String ^ GetDesignTimeHtml();

public override string GetDesignTimeHtml ();

override this.GetDesignTimeHtml : unit -> string

Public Overrides Function GetDesignTimeHtml () As String

傳回

String

用來在設計階段表示控制項的標記。

範例

下列程式代碼範例會 GetDesignTimeHtml 覆寫 方法。 CheckBox.Text如果先前尚未設定 屬性，此方法的呼叫會將它設定為字串，並在設計介面上顯示該字串。 Text如果已經設定屬性，則會顯示現有的屬性值。

' Override the GetDesignTimeHtml method to display a border on the 
' control if the BorderStyle property has not been set by the user.
Public Overrides Function GetDesignTimeHtml() As String

    Dim sampleCheckBox As SampleCheckBox = CType(Component, _
        SampleCheckBox)
    Dim designTimeHtml As String = Nothing

    ' Check the control's BorderStyle property.
    If (sampleCheckBox.BorderStyle = BorderStyle.NotSet) Then

        ' Save the current value of the BorderStyle property.
        Dim oldBorderStyle As BorderStyle = _
            sampleCheckBox.BorderStyle

        ' Change the value of the BorderStyle property and 
        ' generate the design-time HTML.
        Try
            sampleCheckBox.BorderStyle = BorderStyle.Groove
            designTimeHtml = MyBase.GetDesignTimeHtml()

            ' If an exception occurs, call the GetErrorDesignTimeHtml
            ' method.
        Catch ex As Exception
            designTimeHtml = GetErrorDesignTimeHtml(ex)

            ' Restore the BorderStyle property to its original value.
        Finally
            sampleCheckBox.BorderStyle = oldBorderStyle
        End Try

    Else
        designTimeHtml = MyBase.GetDesignTimeHtml()
    End If

    Return designTimeHtml
End Function

備註

Text如果屬性是空的，或只包含空格符，則產生的 HTML 會ID包含複選框控制件的 ，否則產生的 HTML 會包含控件Text屬性的內容。

覆寫此方法以變更產生的 HTML。

另請參閱

• ASP.NET 控件設計工具簡介
• 逐步解說：建立 Web 伺服器控制項的基本控制項設計工具