LoginStatusDesigner.GetDesignTimeHtml Methode

Referenz

Definition

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

Assembly:: System.Design.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 LoginStatus zur Entwurfszeit gerendert wird.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die GetDesignTimeHtml -Methode in einer Klasse überschreiben, die von der LoginStatusDesigner -Klasse geerbt wird, um die Darstellung eines Steuerelements zu ändern, das zur Entwurfszeit von der LoginStatus -Klasse abgeleitet ist. Das Beispiel zeichnet einen blauen gestrichelten Rahmen um das Steuerelement, um seine Ausdehnung sichtbarer zu machen, wenn die BorderStyle Eigenschaft des Steuerelements der NotSet -Wert oder None 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 a blue dashed line. 
    MyLoginStatus myLoginStatusCtl = (MyLoginStatus)ViewControl;
    string markup = null;

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

        // Set the design time properties and catch any exceptions.
        try
        {
            myLoginStatusCtl.BorderStyle = BorderStyle.Dashed;
            myLoginStatusCtl.BorderColor = Color.Blue;

            // Call the base method to generate the markup.
            markup = base.GetDesignTimeHtml();
        }
        catch (Exception ex)
        {
            markup = GetErrorDesignTimeHtml(ex);
        }
        finally
        {
            // It is not necessary to restore the border properties 
            // to their original values because the ViewControl 
            // was used to reference the associated control and the 
            // UsePreviewControl was not overridden.  

            // myLoginCtl.BorderStyle = oldBorderStyle;
            // myLoginCtl.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 a blue dashed line. 
    Dim myLoginStatusCtl As MyLoginStatus = _
        CType(ViewControl, MyLoginStatus)
    Dim markup As String = Nothing

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

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

        ' Set the design time properties and catch any exceptions.
        Try
            myLoginStatusCtl.BorderStyle = BorderStyle.Dashed
            myLoginStatusCtl.BorderColor = Color.Blue

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

        Catch ex As Exception
            markup = GetErrorDesignTimeHtml(ex)

        Finally
            ' It is not necessary to restore the border properties 
            ' to their original values because the ViewControl 
            ' was used to reference the associated control and the 
            ' UsePreviewControl was not overridden.  

            ' myLoginCtl.BorderStyle = oldBorderStyle
            ' myLoginCtl.BorderColor = oldBorderColor
        End Try

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

    Return markup

End Function ' GetDesignTimeHtml

Hinweise

Wenn die LogoutText - oder LoginText -Eigenschaft (abhängig davon, ob der Benutzer angemeldet ist), eine leere Zeichenfolge ("") oder ein einzelnes Leerzeichen ("") ist null, legt die GetDesignTimeHtml -Methode die LogoutText Eigenschaft oder LoginText gegebenenfalls auf die -Eigenschaft fest, die ID in Klammern ("[ ]") eingeschlossen ist. Unabhängig von der Einstellung von LoginText oder ruft die GetDesignTimeHtml Methode dann die GetDesignTimeHtml Basismethode auf, um das Markup für das Entwurfszeitrendering des LoginStatus Steuerelements zu generieren.LogoutText

Hinweise für Vererber

Wenn Sie die GetDesignTimeHtml() -Methode überschreiben, achten Sie darauf, die GetDesignTimeHtml() Basismethode aufzurufen, da sie schließlich über mehrere Überschreibungsebenen das LoginStatus Steuerelement oder eine Kopie des Steuerelements aufruft, um das Markup zu generieren.

Gilt für:

Freigeben über