ListControlDesigner.GetDesignTimeHtml Metod

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

public override string GetDesignTimeHtml();

override this.GetDesignTimeHtml : unit -> string

Public Overrides Function GetDesignTimeHtml () As String

Returer

En String som innehåller den markering som används för att återge kontrollen som härleddes från ListControl vid designtillfället.

Exempel

I följande kodexempel åsidosätts GetDesignTimeHtml metoden för att anpassa den markering som visas för den associerade kontrollen på en designyta. Om egenskapen BackColor inte har definierats för den associerade kontrollen är den inställd på Gainsboro, och kontrollen visas med den bakgrundsfärgen. När detta är klart anropas basimplementeringen av GetDesignTimeHtml metoden.

Det här kodexemplet är en del av ett större exempel för ListControlDesigner klassen.

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

Kommentarer

Om den associerade kontrollen som härleds från ListControl objektet är databunden GetDesignTimeHtml rensar Items metoden samlingen och lägger till ett String meddelande som anger att kontrollen är databunden. Om den associerade kontrollen inte är databunden och Items samlingen är tom lägger GetDesignTimeHtml till ett String meddelande som anger att kontrollen är obundna. GetDesignTimeHtml Anropar sedan dess basmetod för att generera pålägget.

Se även

• Items
• ListItem
• ListControl
• GetDesignTimeHtml()