LoginDesigner Klasse

Definition

public ref class LoginDesigner : System::Web::UI::Design::WebControls::CompositeControlDesigner

public class LoginDesigner : System.Web.UI.Design.WebControls.CompositeControlDesigner

type LoginDesigner = class
    inherit CompositeControlDesigner

Public Class LoginDesigner
Inherits CompositeControlDesigner

Vererbung

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

CompositeControlDesigner

LoginDesigner

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie die LoginDesigner Klasse erweitern, um die Darstellung von Steuerelementen zu ändern, die Login zum Entwurfszeitpunkt vom Steuerelement abgeleitet werden.

Das Beispiel leitet das MyLogin Steuerelement von der Login. Dies MyLogin ist eine Kopie des Login Steuerelements. Das Beispiel leitet auch die Klasse von der MyLoginDesignerLoginDesigner Klasse ab und wendet ein DesignerAttribute Attribut für das MyLoginDesignerMyLogin Steuerelement an.

Die MyLoginDesigner Methode setzt die PreFilterProperties Methode außer Kraft, um die NamingContainer Eigenschaft zur Entwurfszeit im Eigenschaftenraster sichtbar zu machen. Es überschreibt die GetDesignTimeHtml Methode, um einen blauen, gestrichelten Rahmen um das Steuerelement zu zeichnen, um sein Ausmaß sichtbarer zu machen, wenn die BorderStyle Eigenschaft des MyLogin Steuerelements der oder None der NotSet Wert ist. Sie überschreibt die GetErrorDesignTimeHtml Methode, um das Markup für einen Platzhalter zu generieren, der die Fehlermeldung enthält, die rot, fett formatiert wird.

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

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

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

            return CreatePlaceHolderDesignTimeHtml(errorRendering);
        } // GetErrorDesignTimeHtml

        // Shadow the 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()
        {
            // Make the control more visible in the designer.  If the border 
            // style is None or NotSet, change the border to a blue dashed line. 
            MyLogin myLoginCtl = (MyLogin)ViewControl;
            string markup = null;

            // Check if the border style should be changed.
            if (myLoginCtl.BorderStyle == BorderStyle.NotSet ||
                myLoginCtl.BorderStyle == BorderStyle.None)
            {
                BorderStyle oldBorderStyle = myLoginCtl.BorderStyle;
                Color oldBorderColor = myLoginCtl.BorderColor;

                // Set the design time properties and catch any exceptions.
                try
                {
                    myLoginCtl.BorderStyle = BorderStyle.Dashed;
                    myLoginCtl.BorderColor = Color.Blue;

                    // Call the base method to generate the markup.
                    markup = base.GetDesignTimeHtml();
                }
                catch (Exception ex)
                {
                    markup = GetErrorDesignTimeHtml(ex);
                }
                finally
                {
                    // It is not necessary to restore the border properties 
                    // to their original values because the ViewControl 
                    // was used to reference the associated control and the 
                    // UsePreviewControl was not overridden.  

                    // myLoginCtl.BorderStyle = oldBorderStyle;
                    // myLoginCtl.BorderColor = oldBorderColor;
                }
            }
            else
            {
                // Call the base method to generate the markup.
                markup = base.GetDesignTimeHtml();
            }

            return markup;
        } // GetDesignTimeHtml
    } // MyLoginDesigner
} // Examples.CS.WebControls.Design

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

Namespace Examples.VB.WebControls.Design

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

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

        ' 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

        ' Shadow the 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() As String

            ' Make the control more visible in the designer.  If the border 
            ' style is None or NotSet, change the border to a blue dashed line. 
            Dim myLoginCtl As MyLogin = CType(ViewControl, MyLogin)
            Dim markup As String = Nothing

            ' Check if the border style should be changed.
            If (myLoginCtl.BorderStyle = BorderStyle.NotSet Or _
                myLoginCtl.BorderStyle = BorderStyle.None) Then

                Dim oldBorderStyle As BorderStyle = myLoginCtl.BorderStyle
                Dim oldBorderColor As Color = myLoginCtl.BorderColor

                ' Set the design time properties and catch any exceptions.
                Try
                    myLoginCtl.BorderStyle = BorderStyle.Dashed
                    myLoginCtl.BorderColor = Color.Blue

                    ' Call the base method to generate the markup.
                    markup = MyBase.GetDesignTimeHtml()

                Catch ex As Exception
                    markup = GetErrorDesignTimeHtml(ex)

                Finally
                    ' It is not necessary to restore the border properties 
                    ' to their original values because the ViewControl 
                    ' was used to reference the associated control and the 
                    ' UsePreviewControl was not overridden.  

                    ' myLoginCtl.BorderStyle = oldBorderStyle
                    ' myLoginCtl.BorderColor = oldBorderColor
                End Try

            Else
                ' Call the base method to generate the markup.
                markup = MyBase.GetDesignTimeHtml()
            End If

            Return markup

        End Function ' GetDesignTimeHtml
    End Class
End Namespace ' Examples.VB.WebControls.Design

Hinweise

Das Login Steuerelement zeigt eine Benutzeroberfläche an, über die sich ein Benutzer bei der Hostwebsite anmelden kann.

Wenn Sie in einem visuellen Designer von der Quellansicht zur Entwurfsansicht wechseln, wird der Markupquellcode, der das Login 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 LoginDesigner Klasse bietet Entwurfszeitunterstützung für das Login Steuerelement.

Die LoginDesigner Klasseneigenschaften stellen die folgenden Funktionen bereit:

• 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 wird.

• Die AutoFormats Eigenschaft gibt eine Auflistung von Formatierungsschemas für die Anzeige im Dialogfeld "AutoFormat " zurück.

• Die TemplateGroups Eigenschaft gibt eine Auflistung von Vorlagengruppen für die Felder des zugeordneten Login Steuerelements und der Vorlage auf oberster Ebene Login zurück.

• Die UsePreviewControl Eigenschaft gibt immer zurück true, die angibt, dass der Designer eine temporäre Kopie des zugeordneten Login Erstellt, um das Entwurfszeitmarkup zu generieren.

Die LoginDesigner Klassenmethoden stellen die folgenden Funktionen bereit:

• Die GetDesignTimeHtml Methode gibt das Markup zurück, das zum Rendern der zugeordneten Login Entwurfszeit verwendet wird.

• Die GetEditableDesignerRegionContent Methode gibt eine serialisierte Kopie der Vorlage für die zugeordnete Login.

• Die GetErrorDesignTimeHtml Methode stellt das Markup bereit, das zum Rendern der zugeordneten Login Entwurfszeit verwendet wird, wenn ein Fehler aufgetreten ist.

• Die Initialize Methode bereitet den Designer auf das Anzeigen, Bearbeiten und Entwerfen des zugehörigen LoginEntwurfs vor.

• Die PreFilterProperties Methode wird verwendet, um Eigenschaften zu entfernen, zusätzliche Eigenschaften hinzuzufügen oder Schatteneigenschaften der zugeordneten Login.

• Die SetEditableDesignerRegionContent Methode legt einen Bereich der zugeordneten Login aus einer serialisierten Kopie einer Steuerelementvorlage fest.

Weitere Informationen

• Login
• CompositeControl
• WebControl
• CompositeControlDesigner
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• Einführung in ASP.NET Steuerelement-Designer
• Walkthrough: Creating a Basic Control Designer for a Web Server Control