LoginDesigner Класс

Определение

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

Наследование

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

CompositeControlDesigner

LoginDesigner

Примеры

В следующем примере кода показано, как расширить LoginDesigner класс для изменения внешнего вида элементов управления, производных от элемента управления во время разработки Login .

В этом примере элемент управления является производным MyLogin от Login. — MyLogin это копия Login элемента управления . В примере также наследуется MyLoginDesigner класс от LoginDesigner и применяется DesignerAttribute атрибут для MyLoginDesigner в элементе MyLogin управления .

Переопределяет MyLoginDesigner метод , PreFilterProperties чтобы сделать NamingContainer свойство видимым в сетке Свойства во время разработки. Он переопределяет метод для рисования GetDesignTimeHtml синей пунктирной границы вокруг элемента управления, чтобы сделать его экстент более видимым, если BorderStyle свойство MyLogin элемента управления имеет NotSet значение или None . Он переопределяет GetErrorDesignTimeHtml метод для создания разметки для заполнителя, включающего сообщение об ошибке, отображаемое красным полужирным шрифтом.

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

Комментарии

Элемент Login управления отображает пользовательский интерфейс, позволяющий пользователю войти на хост-сайт.

В визуальном конструкторе при переключении из исходного представления в конструктор исходный код разметки, описывающий Login элемент управления, анализируется, и в области конструктора создается версия элемента управления во время разработки. При переключении обратно в представление источника элемент управления времени разработки сохраняется в исходном коде разметки и редактируется в разметке для веб-страницы. Класс LoginDesigner обеспечивает поддержку элемента управления во время разработки Login .

Свойства LoginDesigner класса предоставляют следующие функциональные возможности:

• Свойство ActionLists возвращает DesignerActionListCollection объект , который обычно содержит объект, производный от DesignerActionList класса для каждого уровня в дереве наследования конструктора.

• Свойство AutoFormats возвращает коллекцию схем форматирования для отображения в диалоговом окне Автоформат .

• Свойство TemplateGroups возвращает коллекцию групп шаблонов для полей связанного Login элемента управления и шаблона верхнего уровня Login .

• Свойство UsePreviewControl всегда возвращает trueзначение , указывающее, что конструктор создает временную копию связанного Login объекта для создания разметки времени разработки.

Методы LoginDesigner класса предоставляют следующие функциональные возможности:

• Метод GetDesignTimeHtml возвращает разметку, используемую для отрисовки связанного Login объекта во время разработки.

• Метод GetEditableDesignerRegionContent возвращает сериализованную копию шаблона для связанного Loginобъекта .

• Метод GetErrorDesignTimeHtml предоставляет разметку, которая используется для отрисовки связанного Login объекта во время разработки при возникновении ошибки.

• Метод Initialize подготавливает конструктор к просмотру, изменению и проектированию связанного Loginобъекта .

• Метод PreFilterProperties используется для удаления свойств из , добавления дополнительных свойств в или тени свойств связанного Loginобъекта .

• Метод SetEditableDesignerRegionContent задает область связанного Login из сериализованной копии шаблона элемента управления.

Конструкторы

Свойства

Методы

Явные реализации интерфейса

Применяется к

См. также раздел

• Login
• CompositeControl
• WebControl
• CompositeControlDesigner
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• Общие сведения о конструкторах элементов управления ASP.NET
• Пошаговое руководство. Создание базового Designer элемента управления для серверного веб-элемента управления