LoginViewDesigner Classe

Definição

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

Herança

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

LoginViewDesigner

Exemplos

O exemplo de código seguinte mostra como estender a LoginViewDesigner classe para alterar a aparência e o comportamento dos controlos derivados do LoginView controlo no momento do design.

O exemplo deriva o MyLoginView controlo a partir do LoginView. É MyLoginView uma cópia do LoginView controlo. O exemplo também deriva a MyLoginViewDesigner classe a partir da LoginViewDesigner classe e aplica um DesignerAttribute atributo para o MyLoginViewDesigner no MyLoginView controlo.

O MyLoginViewDesigner controlo sobrepõe-se aos seguintes LoginViewDesigner membros:

• O PreFilterProperties método para tornar a NamingContainer propriedade visível na grelha de Propriedades no momento do projeto.

• O GetDesignTimeHtml método para desenhar uma borda laranja à volta do controlo para tornar a sua extensão mais visível.

• O GetErrorDesignTimeHtml método para gerar a marcação para um marcador que inclui a mensagem de erro, que é apresentada em texto vermelho e negrito.

• O GetEmptyDesignTimeHtml método para gerar a marcação para um marcador que contém os nomes dos grupos de funções definidos para o controlo.

• O Initialize método para lançar uma ArgumentException exceção, se o controlo associado não for um MyLoginView objeto.

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

Observações

O LoginView controlo renderiza um dos seus modelos, determinado por se um utilizador está ligado ao site anfitrião e pelos papéis que contêm a conta de utilizador iniciada.

Num designer visual, quando se muda da vista de Fonte para a vista de Design, o código-fonte de marcação que descreve o LoginView controlo é analisado e uma versão em tempo de design do controlo é criada na superfície de design. Quando regressa à vista Source, o controlo de tempo de design é mantido no código-fonte da marcação e editado na marcação da página Web. A LoginViewDesigner classe fornece suporte em tempo de projeto para o LoginView controlo.

A ActionLists propriedade devolve um DesignerActionListCollection objeto, que normalmente contém um objeto derivado da DesignerActionList classe para cada nível na árvore de herança do designer. A TemplateGroups propriedade devolve uma coleção de grupos de modelos para os modelos do controlo associado LoginView . A UsePreviewControl propriedade devolve truesempre , indicando que o projetista cria uma cópia temporária do controlo associado LoginView para gerar a marcação em tempo de design.

Os LoginViewDesigner métodos de classe fornecem a seguinte funcionalidade:

• Os GetDesignTimeHtml métodos retornam a marcação que é usada para renderizar o controlo associado LoginView no momento do projeto. O GetEmptyDesignTimeHtml método recebe a marcação que gera um marcador para o controlo associado no momento do design, quando o template atual não está definido. O GetErrorDesignTimeHtml método fornece a marcação que renderiza o controlo associado no momento do projeto quando ocorre um erro.

• O GetEditableDesignerRegionContent método devolve uma cópia serializada do modelo atual para o controlo associado LoginView . O SetEditableDesignerRegionContent método define uma região do controlo associado a partir de uma cópia serializada de um modelo de controlo.

• O Initialize método prepara o designer para visualizar, editar e desenhar o controlo associado LoginView . O OnComponentChanged método é chamado quando há uma alteração no controlo associado. O PreFilterProperties método é usado para remover propriedades de, adicionar propriedades adicionais ou propriedades de sombra do controlo associado.

Ver também

• LoginView
• Control
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• Introdução aos Designers de Controlo ASP.NET
• Guia: Criar um Designer Básico de Controlo para um Controlo de Servidor Web