Freigeben über

MenuDesigner.GetDesignTimeHtml Methode

  • Referenz

Definition

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

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

String

Eine Zeichenfolge, die das Markup enthält, mit dem das Menu zur Entwurfszeit gerendert wird.

Beispiele

Das folgende Codebeispiel zeigt, wie die GetDesignTimeHtml -Methode in einer Klasse überschrieben wird, die von der MenuDesigner -Klasse geerbt wird. Die überschriebene Methode ändert die Darstellung eines Steuerelements, das zur Entwurfszeit vom Menu Steuerelement abgeleitet wird. Im Beispiel wird ein orangefarbener, gepunkteter Rahmen um das Steuerelement gezeichnet, um seine Ausdehnung besser sichtbar zu machen, wenn die BorderStyle -Eigenschaft des Steuerelements der - oder None -NotSetWert 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 Entwurfszeitdatenquelle an das zugeordnete Menu Steuerelement zu binden, und ruft dann die GetDesignTimeHtmlGetDesignModeState -Methode auf, um das Steuerelement dazu zu bringen, sein Markup für statische Menu Ansichten und dynamische Ansichten zu generieren. Gibt GetDesignTimeHtml das Markup für die aktuelle Ansicht zurück. Wenn die aktuelle Ansicht nicht definiert ist, ruft die GetDesignTimeHtml Basismethode GetDesignTimeHtml auf.

Gilt für:

Weitere Informationen