LoginViewDesigner Classe

Définition

public ref class LoginViewDesigner : System::Web::UI::Design::ControlDesigner

public class LoginViewDesigner : System.Web.UI.Design.ControlDesigner

type LoginViewDesigner = class
    inherit ControlDesigner

Public Class LoginViewDesigner
Inherits ControlDesigner

Héritage

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

LoginViewDesigner

Exemples

L’exemple de code suivant montre comment étendre la LoginViewDesigner classe pour modifier l’apparence et le comportement des contrôles dérivés du contrôle au moment du LoginView design.

L’exemple dérive le MyLoginView contrôle de .LoginView est MyLoginView une copie du LoginView contrôle. L’exemple dérive également la MyLoginViewDesigner classe de la LoginViewDesigner classe et applique un DesignerAttribute attribut pour le MyLoginViewDesigner sur le MyLoginView contrôle .

Le MyLoginViewDesigner contrôle remplace les membres suivants LoginViewDesigner :

• Méthode PreFilterProperties permettant de rendre la NamingContainer propriété visible dans la grille Propriétés au moment du design.

• Méthode GetDesignTimeHtml permettant de dessiner une bordure orange autour du contrôle pour rendre son étendue plus visible.

• Méthode GetErrorDesignTimeHtml permettant de générer le balisage d’un espace réservé qui inclut le message d’erreur, qui est affiché en rouge, en gras.

• Méthode GetEmptyDesignTimeHtml permettant de générer le balisage d’un espace réservé qui contient les noms des groupes de rôles définis pour le contrôle.

• Méthode Initialize permettant de lever une ArgumentException exception, si le contrôle associé n’est pas un MyLoginView objet .

using System;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.Design;
using System.Web.UI.Design.WebControls;
using System.Collections;
using System.ComponentModel;
using System.Security.Permissions;

namespace Examples.CS.WebControls.Design
{
    // The MyLoginView is a copy of the LoginView.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.MyLoginViewDesigner))]
    public class MyLoginView : LoginView
    {
    } // MyLoginView

    // Override members of the LoginViewDesigner.
    [ReflectionPermission(SecurityAction.Demand, Flags=ReflectionPermissionFlag.MemberAccess)]
    public class MyLoginViewDesigner : LoginViewDesigner
    {
        // Generate the design-time markup for the control when an error occurs.
        protected override string GetErrorDesignTimeHtml(Exception ex) 
        {
            // Write the error message text in red, bold.
            string errorRendering =
                "<span style=\"font-weight:bold; color:Red; \">" +
                ex.Message + "</span>";

            return CreatePlaceHolderDesignTimeHtml(errorRendering);
        } // GetErrorDesignTimeHtml

        // Generate the design-time markup for the control 
        // when the template is empty.
        protected override string GetEmptyDesignTimeHtml()
        {
            // Generate a design-time placeholder containing the names of all
            // the role groups.
            MyLoginView myLoginViewCtl = (MyLoginView)ViewControl;
            RoleGroupCollection roleGroups = myLoginViewCtl.RoleGroups;
            string roleNames = null;

            // If there are any role groups, form a string of their names.
            if (roleGroups.Count > 0)
            {
                roleNames = "Role Groups: <br />   " + 
                    roleGroups[0].ToString();

                for( int rgX = 1; rgX < roleGroups.Count; rgX++ )
                    roleNames += 
                        "<br />   " + roleGroups[rgX].ToString();
            }
            return CreatePlaceHolderDesignTimeHtml( roleNames);
        } // GetEmptyDesignTimeHtml

        // Shadow control properties with design-time properties.
        protected override void PreFilterProperties(IDictionary properties)
        {
            // Call the base method first.
            base.PreFilterProperties(properties);

            // Make the NamingContainer visible in the Properties grid.
            PropertyDescriptor selectProp = 
                (PropertyDescriptor)properties["NamingContainer"];
            properties["NamingContainer"] =
                TypeDescriptor.CreateProperty(selectProp.ComponentType, 
                    selectProp, BrowsableAttribute.Yes);
        } // PreFilterProperties

        // Generate the design-time markup.
        public override string GetDesignTimeHtml(DesignerRegionCollection regions)
        {
            // Make the control more visible in the designer.   
            // Enclose the markup in a table with an orange border. 
            const string openTableMarkup =
                "<table><tr><td style=\"border:4 solid #FF7F00;\">";
            const string closeTableMarkup = "</td></tr></table>";

            // Call the base method to generate the markup.
            string markup = base.GetDesignTimeHtml(regions);

            return openTableMarkup + markup + closeTableMarkup;
        } // GetDesignTimeHtml

        public override void Initialize(IComponent component)
        {
            // Ensure that only a MyLoginView can be created in this designer.
            if (!(component is MyLoginView))
                throw new ArgumentException();

            // Call the base method to generate the markup.
            base.Initialize(component);
        } // Initialize
    } // MyLoginViewDesigner
} // Examples.CS.WebControls.Design

Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design
Imports System.Web.UI.Design.WebControls
Imports System.Collections
Imports System.ComponentModel
Imports System.Security.Permissions
Imports System.IO

Namespace Examples.VB.WebControls.Design

    ' The MyLoginView is a copy of the LoginView.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design.MyLoginViewDesigner))> _
    Public Class MyLoginView
        Inherits LoginView
    End Class

    ' Override members of the LoginViewDesigner.
    <ReflectionPermission(SecurityAction.Demand, Flags:=ReflectionPermissionFlag.MemberAccess)> _
    Public Class MyLoginViewDesigner
        Inherits LoginViewDesigner

        ' Generate the design-time markup for the control when an error occurs.
        Protected Overrides Function GetErrorDesignTimeHtml( _
            ByVal ex As Exception) As String

            ' Write the error message text in red, bold.
            Dim errorRendering As String = _
                "<span style=""font-weight:bold; color:Red; "">" & _
                ex.Message & "</span>"

            Return CreatePlaceHolderDesignTimeHtml(errorRendering)

        End Function ' GetErrorDesignTimeHtml

        ' Generate the design-time markup for the control 
        ' when the template is empty.
        Protected Overrides Function GetEmptyDesignTimeHtml() As String

            ' Generate a design-time placeholder containing the names of all
            ' the role groups.
            Dim myLoginViewCtl As MyLoginView = CType(ViewControl, MyLoginView)
            Dim roleGroups As RoleGroupCollection = myLoginViewCtl.RoleGroups
            Dim RoleNames As String = Nothing
            Dim rgX As Integer

            ' If there are any role groups, form a string of their names.
            If roleGroups.Count > 0 Then

                roleNames = "Role Groups: <br />   " & _
                    roleGroups(0).ToString()

                For rgX = 1 To roleGroups.Count - 1
                    roleNames &= "<br />   " & _
                        roleGroups(rgX).ToString()
                Next rgX
            End If

            Return CreatePlaceHolderDesignTimeHtml(roleNames)

        End Function ' GetEmptyDesignTimeHtml

        ' Shadow control properties with design-time properties.
        Protected Overrides Sub PreFilterProperties( _
            ByVal properties As IDictionary)

            ' Call the base method first.
            MyBase.PreFilterProperties(properties)

            ' Make the NamingContainer visible in the Properties grid.
            Dim selectProp As PropertyDescriptor = _
                CType(properties("NamingContainer"), PropertyDescriptor)
            properties("NamingContainer") = _
                TypeDescriptor.CreateProperty(selectProp.ComponentType, _
                    selectProp, BrowsableAttribute.Yes)

        End Sub

        ' Generate the design-time markup.
        Public Overrides Function GetDesignTimeHtml( _
            ByVal regions As DesignerRegionCollection) As String

            ' Make the control more visible in the designer.  
            ' Enclose the markup in a table with an orange border. 
            Dim openTableMarkup As String = _
                "<table><tr><td style=""border:4 solid #FF7F00;"">"
            Dim closeTableMarkup As String = "</td></tr></table>"

            ' Call the base method to generate the markup.
            Dim markup As String = MyBase.GetDesignTimeHtml(regions)

            Return openTableMarkup & markup & closeTableMarkup

        End Function ' GetDesignTimeHtml

        ' Generate the design time markup.
        Public Overrides Sub Initialize(ByVal component As IComponent)

            ' Ensure that only a MyLoginView can be created in this designer. 
            If Not TypeOf component Is MyLoginView Then
                Throw New ArgumentException()
            End If

            ' Call the base method to generate the markup.
            MyBase.Initialize(component)

        End Sub
    End Class
End Namespace ' Examples.VB.WebControls.Design

Remarques

Le LoginView contrôle affiche l’un de ses modèles, déterminé par si un utilisateur est connecté au site Web hôte et les rôles qui contiennent le compte d’utilisateur connecté.

Dans un concepteur visuel, lorsque vous passez du mode Source au mode Création, le code source de balisage qui décrit le LoginView contrôle est analysé et une version au moment du design du contrôle est créée sur l’aire de conception. Lorsque vous revenez en mode Source, le contrôle au moment du design est conservé dans le code source du balisage et modifié dans le balisage de la page Web. La LoginViewDesigner classe fournit une prise en charge au moment du design pour le LoginView contrôle.

La ActionLists propriété retourne un DesignerActionListCollection objet, qui contient généralement un objet dérivé de la DesignerActionList classe pour chaque niveau de l’arborescence d’héritage du concepteur. La TemplateGroups propriété retourne une collection de groupes de modèles pour les modèles du contrôle associé LoginView . La UsePreviewControl propriété retourne truetoujours , indiquant que le concepteur crée une copie temporaire du contrôle associé LoginView pour générer le balisage au moment du design.

Les LoginViewDesigner méthodes de classe fournissent les fonctionnalités suivantes :

• Les GetDesignTimeHtml méthodes retournent le balisage utilisé pour afficher le contrôle associé LoginView au moment du design. La GetEmptyDesignTimeHtml méthode obtient le balisage qui restitue un espace réservé pour le contrôle associé au moment du design lorsque le modèle actuel n’est pas défini. La GetErrorDesignTimeHtml méthode fournit le balisage qui restitue le contrôle associé au moment du design lorsqu’une erreur s’est produite.

• La GetEditableDesignerRegionContent méthode retourne une copie sérialisée du modèle actuel pour le contrôle associé LoginView . La SetEditableDesignerRegionContent méthode définit une région du contrôle associé à partir d’une copie sérialisée d’un modèle de contrôle.

• La Initialize méthode prépare le concepteur à afficher, modifier et concevoir le contrôle associé LoginView . La OnComponentChanged méthode est appelée en cas de modification du contrôle associé. La PreFilterProperties méthode est utilisée pour supprimer des propriétés du contrôle associé, ajouter des propriétés supplémentaires à ou des propriétés d’ombre du contrôle associé.

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• LoginView
• Control
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• Présentation des concepteurs de contrôles ASP.NET
• Procédure pas à pas : création d’un Designer de contrôle de base pour un contrôle serveur web