LoginDesigner Classe

Definizione

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

Ereditarietà

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

CompositeControlDesigner

LoginDesigner

Esempio

Nell'esempio di codice seguente viene illustrato come estendere la LoginDesigner classe per modificare l'aspetto dei controlli derivati dal Login controllo in fase di progettazione.

L'esempio deriva il MyLogin controllo da Login. MyLogin è una copia del Login controllo . L'esempio deriva anche la MyLoginDesigner classe da LoginDesigner e applica un DesignerAttribute attributo per sul MyLoginDesignerMyLogin controllo .

Esegue MyLoginDesigner l'override del PreFilterProperties metodo per rendere visibile la NamingContainer proprietà nella griglia Proprietà in fase di progettazione. Esegue l'override del GetDesignTimeHtml metodo per disegnare un bordo blu tratteggiato intorno al controllo per renderlo più visibile, se la BorderStyle proprietà del MyLogin controllo è il NotSet valore o None . Esegue l'override del GetErrorDesignTimeHtml metodo per generare il markup per un segnaposto che include il messaggio di errore visualizzato in rosso e in grassetto.

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

Commenti

Il Login controllo visualizza un'interfaccia utente che consente a un utente di accedere al sito Web host.

In una finestra di progettazione visiva, quando si passa dalla visualizzazione Origine a Progettazione, il codice sorgente di markup che descrive il Login controllo viene analizzato e viene creata una versione in fase di progettazione del controllo nell'area di progettazione. Quando si torna alla visualizzazione Origine, il controllo in fase di progettazione viene salvato in modo permanente nel codice sorgente del markup e modificato nel markup per la pagina Web. La LoginDesigner classe fornisce supporto in fase di progettazione per il Login controllo .

Le proprietà della LoginDesigner classe forniscono le funzionalità seguenti:

• La ActionLists proprietà restituisce un DesignerActionListCollection oggetto , che in genere contiene un oggetto derivato dalla DesignerActionList classe per ogni livello nell'albero di ereditarietà della finestra di progettazione.

• La AutoFormats proprietà restituisce una raccolta di schemi di formattazione da visualizzare nella finestra di dialogo Formattazione automatica .

• La TemplateGroups proprietà restituisce una raccolta di gruppi di modelli per i campi del controllo associato Login e il modello di primo livello Login .

• La UsePreviewControl proprietà restituisce truesempre , che indica che la finestra di progettazione crea una copia temporanea dell'oggetto associato Login per generare il markup in fase di progettazione.

I metodi della LoginDesigner classe forniscono le funzionalità seguenti:

• Il GetDesignTimeHtml metodo restituisce il markup utilizzato per eseguire il rendering dell'oggetto associato Login in fase di progettazione.

• Il GetEditableDesignerRegionContent metodo restituisce una copia serializzata del modello per l'oggetto associato Login.

• Il GetErrorDesignTimeHtml metodo fornisce il markup utilizzato per eseguire il rendering dell'oggetto associato Login in fase di progettazione quando si è verificato un errore.

• Il Initialize metodo prepara la finestra di progettazione per visualizzare, modificare e progettare l'oggetto associato Login.

• Il PreFilterProperties metodo viene usato per rimuovere le proprietà da , aggiungere proprietà aggiuntive a o proprietà shadow dell'oggetto associato Login.

• Il SetEditableDesignerRegionContent metodo imposta un'area dell'oggetto associato Login da una copia serializzata di un modello di controllo.

Costruttori

Proprietà

Metodi

Implementazioni dell'interfaccia esplicita

Si applica a

Vedi anche

• Login
• CompositeControl
• WebControl
• CompositeControlDesigner
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• Introduzione alle finestre di progettazione dei controlli di ASP.NET
• Procedura dettagliata: Creazione di un Designer di controllo di base per un controllo server Web