Sdílet prostřednictvím

ListControlDesigner.GetDesignTimeHtml Metoda

  • Reference

Definice

Obor názvů:
System.Web.UI.Design.WebControls
Sestavení:
System.Design.dll

Získá HTML, který se používá k reprezentaci ovládacího prvku v době návrhu.

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

Návraty

String

A String obsahující kód použitý k vykreslení ovládacího prvku odvozeného z návrhu v době návrhu ListControl .

Příklady

Následující příklad kódu přepíše metodu GetDesignTimeHtml pro přizpůsobení revize, která se zobrazí pro přidružený ovládací prvek na návrhové ploše. BackColor Pokud vlastnost není definována pro přidružený ovládací prvek, je nastavena na Gainsboroa ovládací prvek se zobrazí s touto barvou pozadí. Po dokončení je volána základní implementace GetDesignTimeHtml metody.

Tento příklad kódu je součástí většího příkladu zadaného ListControlDesigner pro třídu.

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

Poznámky

Pokud je přidružený ovládací prvek odvozený z objektu ListControl vázán na data, GetDesignTimeHtml metoda vymaže Items kolekci a přidá String zprávu označující, že je ovládací prvek vázán na data. Pokud přidružený ovládací prvek není vázán na data a Items kolekce je prázdná, GetDesignTimeHtml přidá String zprávu označující, že ovládací prvek není příchozí. GetDesignTimeHtml Potom zavolá svou základní metodu, která vygeneruje revize.

Platí pro

Viz také