LoginViewDesigner Klasse

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

Vererbung

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

LoginViewDesigner

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die LoginViewDesigner -Klasse erweitern, um die Darstellung und das Verhalten von Steuerelementen zu ändern, die LoginView zur Entwurfszeit vom Steuerelement abgeleitet werden.

Im Beispiel wird das MyLoginView -Steuerelement von abgeleitet LoginView. Ist MyLoginView eine Kopie des Steuerelements LoginView . Das Beispiel leitet auch die MyLoginViewDesigner -Klasse von der LoginViewDesigner -Klasse ab und wendet ein DesignerAttribute -Attribut für das MyLoginViewDesigner -Steuerelement an MyLoginView .

Das MyLoginViewDesigner Steuerelement setzt die folgenden LoginViewDesigner Member außer Kraft:

• Die PreFilterProperties Methode, um die NamingContainer Eigenschaft zur Entwurfszeit im Raster Eigenschaften sichtbar zu machen.

• Die GetDesignTimeHtml Methode zum Zeichnen eines orangefarbenen Rahmens um das Steuerelement, um dessen Ausdehnung sichtbarer zu machen.

• Die GetErrorDesignTimeHtml Methode zum Generieren des Markups für einen Platzhalter, der die Fehlermeldung enthält, die in roter, fetter Text gerendert wird.

• Die GetEmptyDesignTimeHtml Methode zum Generieren des Markups für einen Platzhalter, der die Namen der Rollengruppen enthält, die für das Steuerelement definiert sind.

• Die Initialize Methode zum Auslösen einer ArgumentException Ausnahme, wenn das zugeordnete Steuerelement kein MyLoginView Objekt ist.

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

Hinweise

Das LoginView Steuerelement rendert eine seiner Vorlagen, die davon bestimmt wird, ob ein Benutzer bei der Hostwebsite angemeldet ist, und die Rollen, die das angemeldete Benutzerkonto enthalten.

Wenn Sie in einem visuellen Designer von der Quellansicht zur Entwurfsansicht wechseln, wird der Markupquellcode, der das LoginView Steuerelement beschreibt, analysiert, und eine Entwurfszeitversion des Steuerelements wird auf der Entwurfsoberfläche erstellt. Wenn Sie zurück zur Quellansicht wechseln, wird das Entwurfszeitsteuerelement im Markupquellcode beibehalten und im Markup für die Webseite bearbeitet. Die LoginViewDesigner -Klasse bietet Entwurfszeitunterstützung für das LoginView Steuerelement.

Die ActionLists -Eigenschaft gibt ein DesignerActionListCollection -Objekt zurück, das in der Regel ein Objekt enthält, das von der DesignerActionList -Klasse für jede Ebene in der Vererbungsstruktur des Designers abgeleitet ist. Die TemplateGroups -Eigenschaft gibt eine Auflistung von Vorlagengruppen für die Vorlagen des zugeordneten LoginView Steuerelements zurück. Die UsePreviewControl -Eigenschaft gibt immer zurück true, was angibt, dass der Designer eine temporäre Kopie des zugeordneten LoginView Steuerelements erstellt, um das Entwurfszeitmarkup zu generieren.

Die LoginViewDesigner Klassenmethoden bieten die folgende Funktionalität:

• Die GetDesignTimeHtml Methoden geben das Markup zurück, das zum Rendern des zugeordneten LoginView Steuerelements zur Entwurfszeit verwendet wird. Die GetEmptyDesignTimeHtml -Methode ruft das Markup ab, das zur Entwurfszeit einen Platzhalter für das zugeordnete Steuerelement rendert, wenn die aktuelle Vorlage nicht definiert ist. Die GetErrorDesignTimeHtml -Methode stellt das Markup bereit, das das zugeordnete Steuerelement zur Entwurfszeit rendert, wenn ein Fehler aufgetreten ist.

• Die GetEditableDesignerRegionContent -Methode gibt eine serialisierte Kopie der aktuellen Vorlage für das zugeordnete LoginView Steuerelement zurück. Die SetEditableDesignerRegionContent -Methode legt einen Bereich des zugeordneten Steuerelements aus einer serialisierten Kopie einer Steuerelementvorlage fest.

• Die Initialize -Methode bereitet den Designer darauf vor, das zugeordnete LoginView Steuerelement anzuzeigen, zu bearbeiten und zu entwerfen. Die OnComponentChanged -Methode wird aufgerufen, wenn eine Änderung am zugeordneten Steuerelement erfolgt. Die PreFilterProperties -Methode wird verwendet, um Eigenschaften aus zu entfernen, zusätzliche Eigenschaften oder Schatteneigenschaften des zugeordneten Steuerelements hinzuzufügen.

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für:

Weitere Informationen

• LoginView
• Control
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• Einführung in ASP.NET Steuerelement-Designer
• Exemplarische Vorgehensweise: Erstellen eines einfachen Steuerelement-Designers für ein Webserversteuerelement