Condividi tramite

ListControlDesigner.GetDesignTimeHtml Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.Design.WebControls
Assembly:
System.Design.dll

Ottiene il codice HTML usato per rappresentare il controllo in fase di progettazione.

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

Restituisce

String

Oggetto String contenente il markup utilizzato per il rendering del controllo derivato da ListControl in fase di progettazione.

Esempio

Nell'esempio di codice seguente viene eseguito l'override del GetDesignTimeHtml metodo per personalizzare il markup visualizzato per il controllo associato in un'area di progettazione. Se la BackColor proprietà non è definita per il controllo associato, viene impostata su Gainsboroe il controllo viene visualizzato con tale colore di sfondo. Al termine, viene chiamata l'implementazione di base del GetDesignTimeHtml metodo .

Questo esempio di codice fa parte di un esempio più ampio fornito per la ListControlDesigner classe .

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

Commenti

Se il controllo associato derivato dall'oggetto ListControl è associato a dati, il GetDesignTimeHtml metodo cancella la Items raccolta e aggiunge un String messaggio che indica che il controllo è associato a dati. Se il controllo associato non è associato a dati e la Items raccolta è vuota, GetDesignTimeHtml aggiunge un String messaggio che indica che il controllo non è associato. Chiama quindi il GetDesignTimeHtml metodo di base per generare il markup.

Si applica a

Vedi anche