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 zur Entwurfszeit vom Steuerelement abgeleitet werden.

Im Beispiel wird das MyLogin -Steuerelement von Loginabgeleitet. ist MyLogin eine Kopie des Login Steuerelements. Das Beispiel leitet auch die MyLoginDesigner -Klasse von ab LoginDesigner und wendet ein DesignerAttribute -Attribut für das MyLoginDesigner -Steuerelement an MyLogin .

Überschreibt MyLoginDesigner die PreFilterProperties -Methode, 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 seine Ausdehnung besser sichtbar zu machen, wenn die BorderStyle -Eigenschaft des Steuerelements MyLogin der - oder None -NotSetWert ist. Es überschreibt die GetErrorDesignTimeHtml -Methode, um das Markup für einen Platzhalter zu generieren, der die fehlermeldung enthält, die in roter, fett formatierter Text gerendert 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, die es einem Benutzer ermöglicht, sich bei der Hostwebsite anzumelden.

Wenn Sie in einem visuellen Designer von der Quell- 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 bieten die folgenden Funktionen:

• 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 zurück, die im Dialogfeld Automatisches Formatieren angezeigt werden.

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

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

Die LoginDesigner Klassenmethoden bieten die folgenden Funktionen:

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

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

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

• Die Initialize -Methode bereitet den Designer auf das Anzeigen, Bearbeiten und Entwerfen des zugeordneten Loginvor.

• Die PreFilterProperties -Methode wird verwendet, um Eigenschaften aus zu entfernen, zusätzliche Eigenschaften zu oder Schatteneigenschaften des zugeordneten Loginhinzuzufügen.

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

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für:

Weitere Informationen

• Login
• CompositeControl
• WebControl
• CompositeControlDesigner
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• Einführung in ASP.NET Control Designer
• Exemplarische Vorgehensweise: Erstellen eines Einfachen Steuerelement-Designers für ein Webserversteuerelement