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 a seguir mostra como estender a LoginViewDesigner classe para alterar a aparência e o comportamento dos controles derivados do LoginView controle em tempo de design.

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

O MyLoginViewDesigner controle substitui os seguintes LoginViewDesigner membros:

• O PreFilterProperties método para tornar a NamingContainer propriedade visível na grade Propriedades em tempo de design.

• O GetDesignTimeHtml método para desenhar uma borda laranja ao redor do controle para tornar sua extensão mais visível.

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

• O GetEmptyDesignTimeHtml método para gerar a marcação para um espaço reservado que contém os nomes dos grupos de função definidos para o controle.

• O Initialize método para gerar uma exceção ArgumentException , se o controle 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

Comentários

O LoginView controle renderiza um de seus modelos, determinado por se um usuário está conectado ao site host e as funções que contêm a conta de usuário conectado.

Em um designer visual, quando você alterna do modo Fonte para Design, o código-fonte de marcação que descreve o LoginView controle é analisado e uma versão em tempo de design do controle é criada na superfície de design. Quando você volta para o Modo de Exibição de origem, o controle de tempo de design é persistido para o código-fonte de marcação e editado na marcação da página da Web. A LoginViewDesigner classe fornece suporte de tempo de design para o LoginView controle .

A ActionLists propriedade retorna 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 retorna uma coleção de grupos de modelos para os modelos do controle associado LoginView . A UsePreviewControl propriedade sempre retorna true, indicando que o designer cria uma cópia temporária do controle associado LoginView para gerar a marcação de tempo de design.

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

• Os GetDesignTimeHtml métodos retornam a marcação usada para renderizar o controle associado LoginView em tempo de design. O GetEmptyDesignTimeHtml método obtém a marcação que renderiza um espaço reservado para o controle associado em tempo de design quando o modelo atual não está definido. O GetErrorDesignTimeHtml método fornece a marcação que renderiza o controle associado em tempo de design quando ocorreu um erro.

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

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

Construtores

Propriedades

Métodos

Implantações explícitas de interface

Aplica-se a

Confira também

• LoginView
• Control
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• Introdução aos Designers de Controle de ASP.NET
• Passo a passo: criando um designer de controle básico para um controle de servidor Web