ListControlDesigner.GetDesignTimeHtml Methode

Referenz

Definition

Namespace:: System.Web.UI.Design.WebControls

Assembly:: System.Design.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den HTML-Code ab, der für die Darstellung des Steuerelements zur Entwurfszeit verwendet wird.

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

public override string GetDesignTimeHtml ();

override this.GetDesignTimeHtml : unit -> string

Public Overrides Function GetDesignTimeHtml () As String

Gibt zurück

String

Ein String, der das Markup enthält, mit dem das von ListControl abgeleitete Steuerelement zur Entwurfszeit gerendert wird.

Beispiele

Im folgenden Codebeispiel wird die GetDesignTimeHtml -Methode zum Anpassen des Markups überschrieben, das für das zugeordnete Steuerelement auf einer Entwurfsoberfläche angezeigt wird. Wenn die BackColor -Eigenschaft nicht für das zugeordnete Steuerelement definiert ist, wird sie auf Gainsborofestgelegt, und das Steuerelement wird mit dieser Hintergrundfarbe angezeigt. Danach wird die Basisimplementierung der GetDesignTimeHtml -Methode aufgerufen.

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ListControlDesigner-Klasse bereitgestellt wird.

// 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

Hinweise

Wenn das vom ListControl Objekt abgeleitete zugeordnete Steuerelement datengebunden ist, löscht die GetDesignTimeHtml -Methode die Items Auflistung und fügt eine String Meldung hinzu, die angibt, dass das Steuerelement datengebunden ist. Wenn das zugeordnete Steuerelement nicht datengebunden ist und die Items Auflistung leer ist, fügt eine String Meldung hinzu, die GetDesignTimeHtml angibt, dass das Steuerelement ungebunden ist. Dann ruft die GetDesignTimeHtml seine Basismethode auf, um das Markup zu generieren.

Gilt für:

Freigeben über