CheckBoxDesigner.GetDesignTimeHtml Método

Definição

Namespace:

System.Web.UI.Design.WebControls

Assembly:

System.Design.dll

Obtém a marcação que é usada para representar o controle no tempo de design.

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

public override string GetDesignTimeHtml ();

override this.GetDesignTimeHtml : unit -> string

Public Overrides Function GetDesignTimeHtml () As String

Retornos

String

A marcação usada para representar o controle em tempo de design.

Exemplos

O exemplo de código a seguir substitui o GetDesignTimeHtml método . Se a CheckBox.Text propriedade não tiver sido definida anteriormente, uma chamada a esse método a definirá como uma cadeia de caracteres e exibirá essa cadeia de caracteres na superfície de design. Se a Text propriedade já tiver sido definida, o valor da propriedade existente será exibido.

' 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

Comentários

Se a Text propriedade estiver vazia ou consistir apenas em espaço em branco, o HTML gerado conterá o ID do controle de caixa de seleção; caso contrário, o HTML gerado conterá o conteúdo da propriedade do Text controle.

Substitua esse método para alterar o HTML gerado.

Confira também

• Introdução aos Designers de Controle de ASP.NET
• Passo a passo: criando um designer de controle básico para um controle de servidor Web