LoginStatusDesigner.GetDesignTimeHtml Méthode

Définition

Espace de noms:

System.Web.UI.Design.WebControls

Assembly:

System.Design.dll

Obtient le balisage utilisé pour afficher le contrôle associé au moment de la conception.

public:
 override System::String ^ GetDesignTimeHtml();

public override string GetDesignTimeHtml ();

override this.GetDesignTimeHtml : unit -> string

Public Overrides Function GetDesignTimeHtml () As String

Retours

String

Chaîne qui contient le balisage utilisé pour rendre LoginStatus au moment du design.

Exemples

L’exemple de code suivant montre comment remplacer la GetDesignTimeHtml méthode dans une classe héritée de la LoginStatusDesigner classe pour modifier l’apparence d’un contrôle dérivé de la LoginStatus classe au moment du design. L’exemple dessine une bordure bleue et pointillée autour du contrôle pour rendre son étendue plus visible, si la BorderStyle propriété du contrôle est la NotSet valeur ou None .

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

Remarques

Si la LogoutText propriété ou LoginText (selon que l’utilisateur est connecté) est null, une chaîne vide («  »), ou un espace unique ( » « ), la GetDesignTimeHtml méthode définit la LogoutText propriété ou LoginText , le cas échéant, sur la ID propriété, placée entre crochets (« [ ] »). Ensuite, quel que soit le paramètre de ou LoginTextLogoutText, la GetDesignTimeHtml méthode appelle la GetDesignTimeHtml méthode de base pour générer le balisage pour le rendu au moment de la conception du LoginStatus contrôle.

Notes pour les héritiers

Si vous remplacez la GetDesignTimeHtml() méthode, veillez à appeler la GetDesignTimeHtml() méthode de base, car elle appelle éventuellement, par le biais de plusieurs niveaux de remplacement, des appels sur le LoginStatus contrôle ou une copie du contrôle pour générer le balisage.

Voir aussi

• LoginStatus
• LoginText
• GetDesignTimeHtml()