ButtonDesigner.GetDesignTimeHtml Método

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.Design.WebControls
Ensamblado:
System.Design.dll

Obtiene el marcado que se usa para representar el control asociado en tiempo de diseño.

public:
 override System::String ^ GetDesignTimeHtml();
public override string GetDesignTimeHtml ();
override this.GetDesignTimeHtml : unit -> string
Public Overrides Function GetDesignTimeHtml () As String

Devoluciones

String

Un objeto String que contiene el marcado usado para representar Button en tiempo de diseño.

Ejemplos

En el ejemplo de código siguiente se muestra cómo invalidar el GetDesignTimeHtml método para cambiar el marcado generado.

Si la BorderStyle propiedad no se ha establecido anteriormente (es decir, tiene el valor de NotSet campo), una llamada al GetDesignTimeHtml método lo establece en un borde de guiones azules con un ancho de tres píxeles y, a continuación, muestra ese borde en la superficie de diseño. Si se ha establecido la BorderStyle propiedad , se muestran los valores de propiedad de borde existentes.

Normalmente, GetDesignTimeHtml llama a su método base, ControlDesigner.GetDesignTimeHtml, que llama al Control.RenderControl método del control asociado para generar el marcado.

' Create a class that derives from ButtonDesigner
' and displays the custom SampleButton control
' on the design surface.
Imports System.Web.UI.Design
Imports System.Drawing
Imports System.ComponentModel
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls

Namespace Examples.AspNet 

    
    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

Comentarios

El GetDesignTimeHtml método reemplaza la Text propiedad por la ID propiedad del Button control si no Text contiene caracteres que se puedan mostrar. A continuación, el GetDesignTimeHtml método llama a su método base, ControlDesigner.GetDesignTimeHtml, que llama al Control.RenderControl método para generar el marcado.

Notas a los desarrolladores de herederos

Si reemplaza el GetDesignTimeHtml() método , normalmente modificará los valores de propiedad seleccionados, llamará al método base para generar el marcado y, a continuación, restaurará las propiedades en sus valores originales.

Se aplica a

Consulte también