LoginViewDesigner Klass

Definition

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

Arv

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

LoginViewDesigner

Exempel

Följande kodexempel visar hur du utökar LoginViewDesigner klassen för att ändra utseendet och beteendet för kontroller som härleds från LoginView kontrollen vid designtillfället.

Exemplet härleder MyLoginView kontrollen från LoginView. MyLoginView är en kopia av LoginView kontrollen. Exemplet härleder MyLoginViewDesigner även klassen från LoginViewDesigner klassen och tillämpar ett DesignerAttribute attribut för MyLoginViewDesignerMyLoginView på -kontrollen.

Kontrollen MyLoginViewDesigner åsidosätter följande LoginViewDesigner medlemmar:

• Metoden PreFilterProperties för att göra NamingContainer egenskapen synlig i rutnätet Egenskaper vid designtillfället.

• Metoden GetDesignTimeHtml för att rita en orange kantlinje runt kontrollen för att göra dess omfattning mer synlig.

• Metoden GetErrorDesignTimeHtml för att generera markering för en platshållare som innehåller felmeddelandet, som återges i röd, fet text.

• Metoden GetEmptyDesignTimeHtml för att generera markering för en platshållare som innehåller namnen på de rollgrupper som har definierats för kontrollen.

• Metoden Initialize för att utlösa ett ArgumentException undantag om den associerade kontrollen inte är ett MyLoginView objekt.

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

Kommentarer

Kontrollen LoginView renderar en av dess mallar, som bestäms av om en användare är inloggad på värdwebbplatsen och de roller som innehåller det inloggade användarkontot.

När du växlar från vyn Källa till Design i en visuell designer parsas källkoden LoginView som beskriver kontrollen och en designtidsversion av kontrollen skapas på designytan. När du växlar tillbaka till källvyn sparas designtidskontrollen till källkoden för markering och redigeras till markering för webbsidan. Klassen LoginViewDesigner ger stöd för designtid för LoginView kontrollen.

Egenskapen ActionLists returnerar ett DesignerActionListCollection objekt som vanligtvis innehåller ett objekt som härleds från DesignerActionList klassen för varje nivå i designerns arvsträd. Egenskapen TemplateGroups returnerar en samling mallgrupper för mallarna för den associerade LoginView kontrollen. Egenskapen UsePreviewControl returnerar truealltid , vilket anger att designern skapar en tillfällig kopia av den associerade LoginView kontrollen för att generera designtidsmarkeringen.

Klassmetoderna LoginViewDesigner tillhandahåller följande funktioner:

• Metoderna GetDesignTimeHtml returnerar den markering som används för att återge den associerade LoginView kontrollen vid designtillfället. Metoden GetEmptyDesignTimeHtml hämtar den markering som återger en platshållare för den associerade kontrollen vid designtillfället när den aktuella mallen inte har definierats. Metoden GetErrorDesignTimeHtml tillhandahåller den markering som återger den associerade kontrollen vid designtillfället när ett fel har inträffat.

• Metoden GetEditableDesignerRegionContent returnerar en serialiserad kopia av den aktuella mallen för den associerade LoginView kontrollen. Metoden SetEditableDesignerRegionContent anger en region för den associerade kontrollen från en serialiserad kopia av en kontrollmall.

• Metoden Initialize förbereder designern för att visa, redigera och utforma den associerade LoginView kontrollen. Metoden OnComponentChanged anropas när den associerade kontrollen ändras. Metoden PreFilterProperties används för att ta bort egenskaper från, lägga till ytterligare egenskaper i eller skuggegenskaper för den associerade kontrollen.

Se även

• LoginView
• Control
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• Introduction till ASP.NET Control Designers
• Genomgång: Skapa en grundläggande kontrolldesigner för en webbserverkontroll