ListControlDesigner.GetDesignTimeHtml Método

Definición

Espacio de nombres:

System.Web.UI.Design.WebControls

Ensamblado:

System.Design.dll

Obtiene el código HTML que se usa para representar el control 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

Objeto String que contiene el marcado utilizado para representar el control que se deriva de ListControl en tiempo de diseño.

Ejemplos

En el ejemplo de código siguiente se reemplaza el GetDesignTimeHtml método para personalizar el marcado que se muestra para el control asociado en una superficie de diseño. Si la BackColor propiedad no está definida para el control asociado, se establece Gainsboroen y el control se muestra con ese color de fondo. Una vez hecho esto, se llama a la implementación base del GetDesignTimeHtml método .

Este ejemplo de código es parte de un ejemplo mayor proporcionado para la clase ListControlDesigner.

// Create the markup to display the control on the design surface. 
public override string GetDesignTimeHtml()
{
    string designTimeMarkup = null;

    // Create variables to access the control
    // item collection and back color.
    ListItemCollection items = simpleRadioButtonList.Items;
    Color oldBackColor = simpleRadioButtonList.BackColor;

    // Check the property values and render the markup
    // on the design surface accordingly.
    try
    {
        if (oldBackColor == Color.Empty)
            simpleRadioButtonList.BackColor = Color.Gainsboro;

        if (changedDataSource)
            items.Add("Updated to a new data source: " + 
                DataSource + ".");

        // Call the base method to generate the markup.
        designTimeMarkup = base.GetDesignTimeHtml();
    }
    catch (Exception ex)
    {
        // Catch any exceptions that occur.
        designTimeMarkup = GetErrorDesignTimeHtml(ex);
    }
    finally
    {
        // Set the properties back to their original state.
        simpleRadioButtonList.BackColor = oldBackColor;
        items.Clear();
    }

    return designTimeMarkup;
} // GetDesignTimeHtml

' Create the markup to display the control on the design surface.
Public Overrides Function GetDesignTimeHtml() As String

    Dim designTimeHtml As String = String.Empty

    ' Create variables to access the control's
    ' item collection and back color. 
    Dim items As ListItemCollection = simpleRadioButtonList.Items
    Dim oldBackColor As Color = simpleRadioButtonList.BackColor

    ' Check the property values and render the markup
    ' on the design surface accordingly.
    Try
        If (Color.op_Equality(oldBackColor, Color.Empty)) Then
            simpleRadioButtonList.BackColor = Color.Gainsboro
        End If

        If (changedDataSource) Then
            items.Add( _
                "Updated to a new data source: " & DataSource & ".")
        End If

        designTimeHtml = MyBase.GetDesignTimeHtml()

    Catch ex As Exception
        ' Catch any exceptions that occur.
        MyBase.GetErrorDesignTimeHtml(ex)

    Finally
        ' Set the properties back to their original state.
        simpleRadioButtonList.BackColor = oldBackColor
        items.Clear()
    End Try

    Return designTimeHtml
End Function ' GetDesignTimeHtml

Comentarios

Si el control asociado derivado del ListControl objeto está enlazado a datos, el GetDesignTimeHtml método borra la Items colección y agrega un String mensaje que indica que el control está enlazado a datos. Si el control asociado no está enlazado a datos y la Items colección está vacía, GetDesignTimeHtml agrega un String mensaje que indica que el control no está enlazado. A continuación, GetDesignTimeHtml llama a su método base para generar el marcado.

Consulte también

• Items
• ListItem
• ListControl
• GetDesignTimeHtml()