Freigeben über


MenuDesigner.GetDesignTimeHtml Methode

Definition

Ruft das Markup ab, das zum Rendern des zugeordneten 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

Eine Zeichenfolge, die das Markup enthält, das zum Rendern der Menu Entwurfszeit verwendet wird.

Beispiele

Das folgende Codebeispiel zeigt, wie die GetDesignTimeHtml Methode in einer Klasse überschreibt, die von der MenuDesigner Klasse geerbt wird. Die überschriebene Methode ändert das Erscheinungsbild eines Steuerelements, das zur Entwurfszeit vom Menu Steuerelement abgeleitet wird. Im Beispiel wird ein orangefarbener, gepunkteter Rahmen um das Steuerelement gezeichnet, um dessen Umfang sichtbarer zu machen, wenn die BorderStyle Eigenschaft des Steuerelements der Wert None oder der NotSet Wert ist.

// Generate the design-time markup.
public override string GetDesignTimeHtml()
{
    // Make the control more visible in the designer.  If the border 
    // style is None or NotSet, change the border to an orange dotted line. 
    MyMenu myMenuCtl = (MyMenu)ViewControl;
    string markup = null;

    // Check if the border style should be changed.
    if (myMenuCtl.BorderStyle == BorderStyle.NotSet ||
        myMenuCtl.BorderStyle == BorderStyle.None)
    {
        BorderStyle oldBorderStyle = myMenuCtl.BorderStyle;
        Color oldBorderColor = myMenuCtl.BorderColor;

        // Set the design-time properties and catch any exceptions.
        try
        {
            myMenuCtl.BorderStyle = BorderStyle.Dotted;
            myMenuCtl.BorderColor = Color.FromArgb(0xFF7F00);

            // Call the base method to generate the markup.
            markup = base.GetDesignTimeHtml();
        }
        catch (Exception ex)
        {
            markup = GetErrorDesignTimeHtml(ex);
        }
        finally
        {
            // Restore the properties to their original settings.
            myMenuCtl.BorderStyle = oldBorderStyle;
            myMenuCtl.BorderColor = oldBorderColor;
        }
    }
    else
    {
        // Call the base method to generate the markup.
        markup = base.GetDesignTimeHtml();
    }

    return markup;
} // GetDesignTimeHtml
' Generate the design-time markup.
Public Overrides Function GetDesignTimeHtml() As String

    ' Make the control more visible in the designer.  If the border 
    ' style is None or NotSet, change the border to an orange dotted line. 
    Dim myMenuCtl As MyMenu = CType(ViewControl, MyMenu)
    Dim markup As String = Nothing

    ' Check if the border style should be changed.
    If (myMenuCtl.BorderStyle = BorderStyle.NotSet Or _
        myMenuCtl.BorderStyle = BorderStyle.None) Then

        Dim oldBorderStyle As BorderStyle = myMenuCtl.BorderStyle
        Dim oldBorderColor As Color = myMenuCtl.BorderColor

        ' Set the design-time properties and catch any exceptions.
        Try
            myMenuCtl.BorderStyle = BorderStyle.Dotted
            myMenuCtl.BorderColor = Color.FromArgb(&HFF7F00)

            ' Call the base method to generate the markup.
            markup = MyBase.GetDesignTimeHtml()

        Catch ex As Exception
            markup = GetErrorDesignTimeHtml(ex)

        Finally
            ' Restore the properties to their original settings.
            myMenuCtl.BorderStyle = oldBorderStyle
            myMenuCtl.BorderColor = oldBorderColor
        End Try

    Else
        ' Call the base method to generate the markup.
        markup = MyBase.GetDesignTimeHtml()
    End If

    Return markup

End Function ' GetDesignTimeHtml

Hinweise

Die GetDesignTimeHtml Methode ruft die DataBind Methode auf, um die Entwurfszeit-Datenquelle an das zugeordnete Menu Steuerelement zu binden, und ruft dann die GetDesignTimeHtmlGetDesignModeState Methode auf, damit das Menu Steuerelement das Markup für statische Ansicht und dynamische Ansicht generiert. Das GetDesignTimeHtml Markup für die aktuelle Ansicht wird zurückgegeben. Wenn die aktuelle Ansicht nicht definiert ist, ruft die GetDesignTimeHtmlGetDesignTimeHtml Basismethode auf.

Gilt für:

Weitere Informationen