LoginStatusDesigner Класс

Ссылка

Определение

Пространство имен:: System.Web.UI.Design.WebControls

Сборка:: System.Design.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет поддержку во время разработки в визуальном конструкторе для элемента управления веб-сервера LoginStatus.

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

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

type LoginStatusDesigner = class
    inherit CompositeControlDesigner

Public Class LoginStatusDesigner
Inherits CompositeControlDesigner

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

ComponentDesigner

HtmlControlDesigner

ControlDesigner

CompositeControlDesigner
LoginStatusDesigner

Примеры

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

В этом примере элемент управления является производным MyLoginStatus от LoginStatus. — MyLoginStatus это копия LoginStatus элемента управления . В примере также наследуется MyLoginStatusDesigner класс от LoginStatusDesigner, а затем применяется DesignerAttribute атрибут для MyLoginStatusDesigner в элементе MyLoginStatus управления .

Переопределяет MyLoginStatusDesigner метод для рисования GetDesignTimeHtml синей пунктирной границы вокруг элемента управления, чтобы сделать его более видимым, если BorderStyle свойство MyLoginStatus объекта имеет NotSet значение или None .

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;
using System.IO;

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

    // Override members of the LoginStatusDesigner.
    public class MyLoginStatusDesigner : LoginStatusDesigner
    {
        // 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. 
            MyLoginStatus myLoginStatusCtl = (MyLoginStatus)ViewControl;
            string markup = null;

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

                // Set the design time properties and catch any exceptions.
                try
                {
                    myLoginStatusCtl.BorderStyle = BorderStyle.Dashed;
                    myLoginStatusCtl.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
    } // MyLoginStatusDesigner
} // 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 MyLoginStatus is a copy of the LoginStatus.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design.MyLoginStatusDesigner))> _
    Public Class MyLoginStatus
        Inherits LoginStatus
    End Class

    ' Override members of the LoginStatusDesigner.
    Public Class MyLoginStatusDesigner
        Inherits LoginStatusDesigner

        ' 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 myLoginStatusCtl As MyLoginStatus = _
                CType(ViewControl, MyLoginStatus)
            Dim markup As String = Nothing

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

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

                ' Set the design time properties and catch any exceptions.
                Try
                    myLoginStatusCtl.BorderStyle = BorderStyle.Dashed
                    myLoginStatusCtl.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

Элемент LoginStatus управления отображает кнопку, которая автоматически проверяет состояние проверки подлинности пользователя и отображает соответствующий параметр входа или выхода.

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

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

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

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

LoginStatusDesigner()

Инициализирует новый экземпляр класса LoginStatusDesigner.

Свойства

ActionLists	Получает коллекцию списков действий данного конструктора.
AllowResize	Получает значение, указывающее, можно ли изменять размер элемента управления в среде времени разработки. (Унаследовано от ControlDesigner)
AssociatedComponents	Получает коллекцию компонентов, сопоставленных компоненту, который управляется конструктором. (Унаследовано от ComponentDesigner)
AutoFormats	Получает коллекцию предварительно определенных схем автоматического форматирования, которые будут отображаться в диалоговом окне Автоформат для связанного элемента управления во время разработки. (Унаследовано от ControlDesigner)
Behavior	Устаревшие.. Получает или задает поведение DHTML, связанное с конструктором. (Унаследовано от HtmlControlDesigner)
Component	Возвращает основной компонент, создаваемый данным конструктором. (Унаследовано от ComponentDesigner)
DataBindings	Получает коллекцию привязок данных для текущего элемента управления. (Унаследовано от HtmlControlDesigner)
DataBindingsEnabled	Получает значение, указывающее, поддерживается ли привязка данных областью, содержащей элемент управления. (Унаследовано от ControlDesigner)
DesignerState	Получает объект, используемый для сохранения данных сопоставленного элемента управления во время разработки. (Унаследовано от ControlDesigner)
DesignTimeElement	Устаревшие.. Возвращает объект времени разработки, представляющий элемент управления, сопоставленный с объектом HtmlControlDesigner в области разработки. (Унаследовано от HtmlControlDesigner)
DesignTimeElementView	Устаревшие.. Получает объект элемента управления представлением для конструктора элементов управления. (Унаследовано от ControlDesigner)
DesignTimeHtmlRequiresLoadComplete	Устаревшие.. Получает значение, указывающее, должна ли быть завершена загрузка основным приложением разработки до вызова метода GetDesignTimeHtml. (Унаследовано от ControlDesigner)
Expressions	Возвращает привязки выражений для текущего элемента управления во время разработки. (Унаследовано от HtmlControlDesigner)
HidePropertiesInTemplateMode	Получает значение, указывающее, скрыты ли свойства сопоставленного элемента управления, когда он находится в режиме шаблона. (Унаследовано от ControlDesigner)
ID	Получает или задает строку идентификатора элемента управления. (Унаследовано от ControlDesigner)
InheritanceAttribute	Возвращает атрибут, обозначающий тип наследования связанного компонента. (Унаследовано от ComponentDesigner)
Inherited	Возвращает значение, определяющее, наследуется ли этот компонент или нет. (Унаследовано от ComponentDesigner)
InTemplateMode	получает значение, указывающее, находится ли элемент управления в режиме просмотра или редактирования шаблона в основном приложении разработки. Свойство InTemplateMode доступно только для чтения. (Унаследовано от ControlDesigner)
IsDirty	Устаревшие.. Получает или задает значение, указывающее наличие отметки об изменении серверного веб-элемента управления. (Унаследовано от ControlDesigner)
ParentComponent	Возвращает родительский компонент этого конструктора. (Унаследовано от ComponentDesigner)
ReadOnly	Устаревшие.. Получает или задает значение, указывающее, доступны ли только для чтения свойства элемента управления во время разработки. (Унаследовано от ControlDesigner)
RootDesigner	Получает конструктор элементов управления для страницы веб-форм, содержащей сопоставленный элемент управления. (Унаследовано от ControlDesigner)
SetTextualDefaultProperty	Предоставляет поддержку во время разработки в визуальном конструкторе для элемента управления веб-сервера LoginStatus. (Унаследовано от ComponentDesigner)
ShadowProperties	Возвращает коллекцию значений свойств, переопределяющих параметры пользователя. (Унаследовано от ComponentDesigner)
ShouldCodeSerialize	Устаревшие.. Получает или задает значение, показывающее, создавать ли объявление поля для элемента управления в файле кода программной части для текущего документа разработки во время сериализации. (Унаследовано от HtmlControlDesigner)
Tag	Получает объект, представляющей элемент разметки HTML для сопоставленного элемента управления. (Унаследовано от ControlDesigner)
TemplateGroups	Получает коллекцию групп шаблонов, каждая из которых содержит одно или несколько определений шаблонов. (Унаследовано от ControlDesigner)
UsePreviewControl	Получает значение, указывающее, должен ли конструктор использовать при создании разметки времени разработки временную копию вместо фактического элемента управления.
Verbs	Возвращает команды в режиме конструктора, поддерживаемые компонентом, связанным с конструктором. (Унаследовано от ComponentDesigner)
ViewControl	Получает или задает серверный веб-элемент управления, который может быть использован для предварительного просмотра разметки HTML времени разработки. (Унаследовано от ControlDesigner)
ViewControlCreated	Получает или задает значение, указывающее, создан ли элемент управления `View` для отображения в рабочей области конструирования. (Унаследовано от ControlDesigner)
Visible	Получает значение, указывающее, является ли элемент управления видимым во время разработки. (Унаследовано от ControlDesigner)

Методы

CreateChildControls()	Создает дочерние элементы управления этого элемента управления CompositeControl. (Унаследовано от CompositeControlDesigner)
CreateErrorDesignTimeHtml(String)	Создает разметку HTML для отображения указанного сообщения об ошибке во время разработки. (Унаследовано от ControlDesigner)
CreateErrorDesignTimeHtml(String, Exception)	Создает разметку HTML для отображения во время разработки указанного сообщения об ошибке, вызванной исключением. (Унаследовано от ControlDesigner)
CreatePlaceHolderDesignTimeHtml()	Предоставляет простое прямоугольное представление местозаполнителя, в котором выводится тип и идентификатор элемента управления. (Унаследовано от ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)	Предоставляет простое прямоугольное представление местозаполнителя, в котором выводится тип и идентификатор элемента управления, а также дополнительно указанные инструкции или сведения. (Унаследовано от ControlDesigner)
CreateViewControl()	Возвращает копию связанного элемента управления для просмотра или отрисовки в рабочей области конструирования. (Унаследовано от ControlDesigner)
Dispose()	Освобождает все ресурсы, занятые модулем ComponentDesigner. (Унаследовано от ComponentDesigner)
Dispose(Boolean)	Освобождает неуправляемые (а при необходимости и управляемые) ресурсы, используемые объектом HtmlControlDesigner. (Унаследовано от HtmlControlDesigner)
DoDefaultAction()	Создает в файле с исходным кодом подпись метода для события по умолчанию для компонента и устанавливает курсор в позицию, где была создана эта подпись. (Унаследовано от ComponentDesigner)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetBounds()	Получает координаты прямоугольника, представляющего границы элемента управления, когда он отображается в рабочей области конструирования. (Унаследовано от ControlDesigner)
GetDesignTimeHtml()	Получает разметку, используемую для отрисовки связанного элемента управления во время разработки.
GetDesignTimeHtml(DesignerRegionCollection)	Получает разметку HTML для отображения элемента управления и заполняет коллекцию текущими областями конструктора элемента управления. (Унаследовано от ControlDesigner)
GetEditableDesignerRegionContent(EditableDesignerRegion)	Возвращает содержимое редактируемой области представления времени разработки связанного элемента управления. (Унаследовано от ControlDesigner)
GetEmptyDesignTimeHtml()	Извлекает разметку HTML, используемую для представления северного веб-элемента управления во время разработки, у которого не будет визуального представления во время выполнения. (Унаследовано от ControlDesigner)
GetErrorDesignTimeHtml(Exception)	Получает HTML-разметку, которая предоставляет сведения об указанном исключении. (Унаследовано от ControlDesigner)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetPersistenceContent()	Получает сохраненную внутреннюю разметку HTML элемента управления во время разработки. (Унаследовано от ControlDesigner)
GetPersistInnerHtml()	Устаревшие.. Получает сохраненную внутреннюю разметку HTML элемента управления. (Унаследовано от ControlDesigner)
GetService(Type)	Пытается извлечь службу заданного типа с узла режима разработки компонента конструктора. (Унаследовано от ComponentDesigner)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetViewRendering()	Получает объект, содержащий разметку времени разработки для содержимого и областей сопоставленного элемента управления. (Унаследовано от ControlDesigner)
Initialize(IComponent)	Подготавливает конструктор для просмотра, редактирования и разработки связанного элемента управления.
InitializeExistingComponent(IDictionary)	Выполняет повторную инициализацию существующего компонента. (Унаследовано от ComponentDesigner)
InitializeNewComponent(IDictionary)	Инициализирует только что созданный компонент. (Унаследовано от ComponentDesigner)
InitializeNonDefault()	Устаревшие.. Устаревшие.. Инициализирует параметры импортированного компонента, параметры которого уже были инициализированы с использованием параметров, отличных от заданных по умолчанию. (Унаследовано от ComponentDesigner)
Invalidate()	Делает недействительной целую область элемента управления, отображаемого в рабочей области конструирования, и сигнализирует конструктору элементов управления о необходимости перерисовки элемента управления. (Унаследовано от ControlDesigner)
Invalidate(Rectangle)	Делает недействительной указанную область элемента управления, отображаемого в рабочей области конструирования, и сигнализирует конструктору элемента управления о необходимости перерисовки элемента управления. (Унаследовано от ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)	Возвращает атрибут InheritanceAttribute заданного объекта ComponentDesigner. (Унаследовано от ComponentDesigner)
IsPropertyBound(String)	Устаревшие.. Получает значение, указывающее, является ли указанное свойство сопоставленного элемента управления привязанным к данным. (Унаследовано от ControlDesigner)
Localize(IDesignTimeResourceWriter)	Использует предоставленный модуль записи ресурсов для сохранения локализуемых свойств сопоставленного элемента управления в ресурсе основного приложения разработки. (Унаследовано от ControlDesigner)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnAutoFormatApplied(DesignerAutoFormat)	Вызывается, когда предварительно определенная схема автоматического форматирования применяется к сопоставленному элементу управления. (Унаследовано от ControlDesigner)
OnBehaviorAttached()	Вызывается, когда конструктор элемента управления вложен в объект Behavior. (Унаследовано от ControlDesigner)
OnBehaviorDetaching()	Устаревшие.. Вызывается при разрыве связи поведения и элемента. (Унаследовано от HtmlControlDesigner)
OnBindingsCollectionChanged(String)	Устаревшие.. Вызывается при изменении коллекции привязки данных. (Унаследовано от ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)	Вызывается основным приложением разработки, когда пользователь во время разработки щелкает сопоставленный элемент управления. (Унаследовано от ControlDesigner)
OnComponentChanged(Object, ComponentChangedEventArgs)	Вызывается при изменении сопоставленного элемента управления. (Унаследовано от ControlDesigner)
OnComponentChanging(Object, ComponentChangingEventArgs)	Предоставляет метод, обрабатывающий событие ComponentChanging для сопоставленного элемента управления. (Унаследовано от ControlDesigner)
OnControlResize()	Устаревшие.. Вызывается, когда изменяется размер сопоставленного серверного веб-элемента управления в основном приложении разработки во время разработки. (Унаследовано от ControlDesigner)
OnPaint(PaintEventArgs)	Вызывается, когда конструктор элементов управления прорисовывает сопоставленный элемент управления в рабочей области конструирования, если значением поля CustomPaint является `true`. (Унаследовано от ControlDesigner)
OnSetComponentDefaults()	Устаревшие.. Устаревшие.. Задает для компонента свойства по умолчанию. (Унаследовано от ComponentDesigner)
OnSetParent()	Предоставляет способ выполнения дополнительной обработки, когда сопоставленный элемент управления сопоставляется с родительским элементом управления. (Унаследовано от HtmlControlDesigner)
PostFilterAttributes(IDictionary)	Позволяет конструктору изменять или удалять элементы из набора атрибутов, предоставленных через класс TypeDescriptor. (Унаследовано от ComponentDesigner)
PostFilterEvents(IDictionary)	Позволяет конструктору изменять или удалять элементы из набора событий, предоставленных через класс TypeDescriptor. (Унаследовано от ComponentDesigner)
PostFilterProperties(IDictionary)	Позволяет конструктору изменять или удалять элементы из набора свойств, предоставленных с использованием класса TypeDescriptor. (Унаследовано от ComponentDesigner)
PreFilterAttributes(IDictionary)	Позволяет конструктору добавлять элементы к набору атрибутов, предоставленному с использованием класса TypeDescriptor. (Унаследовано от ComponentDesigner)
PreFilterEvents(IDictionary)	Определяет список событий, предоставляемых во время разработки для объекта TypeDescriptor компонента. (Унаследовано от HtmlControlDesigner)
PreFilterProperties(IDictionary)	Добавляет свойства в сетку свойств в основном приложении разработки во время разработки или удаляет их из этой сетки либо предоставляет новые свойства времени разработки, которые могут соответствовать свойствам сопоставленного элемента управления. (Унаследовано от ControlDesigner)
RaiseComponentChanged(MemberDescriptor, Object, Object)	Уведомляет службу IComponentChangeService о том, что данный компонент был изменен. (Унаследовано от ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)	Уведомляет службу IComponentChangeService о том, что компонент будет изменен. (Унаследовано от ComponentDesigner)
RaiseResizeEvent()	Устаревшие.. Вызывает событие OnControlResize(). (Унаследовано от ControlDesigner)
RegisterClone(Object, Object)	Регистрирует внутренние данные в клонированном элементе управления. (Унаследовано от ControlDesigner)
SetEditableDesignerRegionContent(EditableDesignerRegion, String)	Указывает содержимое редактируемой области элемента управления во время разработки. (Унаследовано от ControlDesigner)
SetRegionContent(EditableDesignerRegion, String)	Указывает содержимое редактируемой области в представлении времени разработки элемента управления. (Унаследовано от ControlDesigner)
SetViewFlags(ViewFlags, Boolean)	Назначает указанное битовое перечисление ViewFlags указанному значению флага. (Унаследовано от ControlDesigner)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
UpdateDesignTimeHtml()	Обновляет разметку HTML времени разработки для сопоставленного серверного веб-элемента управления посредством вызова метода GetDesignTimeHtml. (Унаследовано от ControlDesigner)

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

IDesignerFilter.PostFilterAttributes(IDictionary)	Описание этого элемента содержится в методе PostFilterAttributes(IDictionary). (Унаследовано от ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)	Описание этого элемента содержится в методе PostFilterEvents(IDictionary). (Унаследовано от ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)	Описание этого элемента содержится в методе PostFilterProperties(IDictionary). (Унаследовано от ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)	Описание этого элемента содержится в методе PreFilterAttributes(IDictionary). (Унаследовано от ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)	Описание этого элемента содержится в методе PreFilterEvents(IDictionary). (Унаследовано от ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)	Описание этого элемента содержится в методе PreFilterProperties(IDictionary). (Унаследовано от ComponentDesigner)
ITreeDesigner.Children	Описание этого элемента см. в свойстве Children. (Унаследовано от ComponentDesigner)
ITreeDesigner.Parent	Описание этого элемента см. в свойстве Parent. (Унаследовано от ComponentDesigner)

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

LoginStatusDesigner Класс

Определение

Примеры

Комментарии

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

Свойства

Методы

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

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

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

Обратная связь

Дополнительные ресурсы