LabelDesigner Класс

Определение

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

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

Важно!

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

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

public ref class LabelDesigner : System::Web::UI::Design::TextControlDesigner

public class LabelDesigner : System.Web.UI.Design.TextControlDesigner

[System.Web.UI.Design.SupportsPreviewControl(true)]
public class LabelDesigner : System.Web.UI.Design.TextControlDesigner

type LabelDesigner = class
    inherit TextControlDesigner

[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type LabelDesigner = class
    inherit TextControlDesigner

Public Class LabelDesigner
Inherits TextControlDesigner

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

ComponentDesigner

HtmlControlDesigner

ControlDesigner

TextControlDesigner
LabelDesigner

Атрибуты: SupportsPreviewControlAttribute

Примеры

В следующем примере кода показано, как наследовать SampleLabel элемент управления от Label элемента управления и применить DesignerAttribute атрибут к SampleLabel элементу управления, чтобы связать его с классом SampleLabelDesigner .

Пример кода также является производным SampleLabelDesigner от LabelDesigner класса. Он переопределяет GetDesignTimeHtml метод, чтобы задать BorderStyle для свойства Dashedзначение , если исходный BorderStyle NotSet объект был или None значение. Это повышает видимость связанного элемента управления во время разработки.

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

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

    // Override members of the LabelDesigner.
    public class SampleLabelDesigner : LabelDesigner
    {
        // 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 dashed line. 
            SampleLabel sampleLabel = (SampleLabel)Component;
            string designTimeMarkup = null;

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

                try
                {
                    // Set the design-time BorderStyle.
                    sampleLabel.BorderStyle = BorderStyle.Dashed;

                    // Call the base method to generate the markup.
                    designTimeMarkup = base.GetDesignTimeHtml();
                }
                catch (Exception ex)
                {
                    // If an exception occurs, generate an error message.
                    designTimeMarkup = GetErrorDesignTimeHtml(ex);
                }
                finally
                {
                    // Restore the BorderStyle to its original setting.
                    sampleLabel.BorderStyle = oldBorderStyle;
                }
            }
            else
            {
                // Call the base method to generate the markup.
                designTimeMarkup = base.GetDesignTimeHtml();
            }

            return designTimeMarkup;
        } // GetDesignTimeHtml
    } // SampleLabelDesigner
} // Examples.CS.WebControls.Design

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

Namespace Examples.VB.WebControls.Design

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

    ' Override members of the LabelDesigner.
    Public Class SampleLabelDesigner
        Inherits LabelDesigner

        ' 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 dashed line. 
            Dim sampleLabel As SampleLabel = CType(Component, SampleLabel)
            Dim designTimeMarkup As String = Nothing

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

                Dim oldBorderStyle As BorderStyle = sampleLabel.BorderStyle

                Try
                    ' Set the design-time BorderStyle.
                    sampleLabel.BorderStyle = BorderStyle.Dashed

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

                Catch ex As Exception
                    ' If an exception occurs, generate an error message.
                    designTimeMarkup = GetErrorDesignTimeHtml(ex)

                Finally
                    ' Restore the BorderStyle to its original setting.
                    sampleLabel.BorderStyle = oldBorderStyle
                End Try

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

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

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

Метод OnComponentChanged вызывается при изменении связанного Label элемента управления.

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

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

Свойства

Имя	Описание
ActionLists	Возвращает коллекцию списков действий для конструктора элементов управления. (Унаследовано от ControlDesigner)
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)
ShadowProperties	Возвращает коллекцию значений свойств, которые переопределяют параметры пользователя. (Унаследовано от ComponentDesigner)
ShouldCodeSerialize	Устаревшие.. Возвращает или задает значение, указывающее, следует ли создавать объявление поля для элемента управления в файле программной части текущего документа конструктора во время сериализации. (Унаследовано от HtmlControlDesigner)
Tag	Возвращает объект, представляющий элемент разметки HTML для связанного элемента управления. (Унаследовано от ControlDesigner)
TemplateGroups	Получает коллекцию групп шаблонов, каждая из которых содержит одно или несколько определений шаблонов. (Унаследовано от ControlDesigner)
UsePreviewControl	Возвращает значение, указывающее, использует ли конструктор элементов управления временный предварительный просмотр для создания разметки HTML во время разработки. (Унаследовано от ControlDesigner)
Verbs	Возвращает команды времени разработки, поддерживаемые компонентом, связанным с конструктором. (Унаследовано от ComponentDesigner)
ViewControl	Возвращает или задает элемент управления веб-сервера, который можно использовать для предварительного просмотра разметки HTML во время разработки. (Унаследовано от ControlDesigner)
ViewControlCreated	Возвращает или задает значение, указывающее, был ли `View` элемент управления создан для отображения на поверхности конструктора. (Унаследовано от ControlDesigner)
Visible	Возвращает значение, указывающее, отображается ли элемент управления во время разработки. (Унаследовано от ControlDesigner)

Методы

Имя	Описание
CreateErrorDesignTimeHtml(String, Exception)	Создает разметку HTML для отображения указанного сообщения об ошибке исключения во время разработки. (Унаследовано от ControlDesigner)
CreateErrorDesignTimeHtml(String)	Создает разметку HTML для отображения указанного сообщения об ошибке во время разработки. (Унаследовано от ControlDesigner)
CreatePlaceHolderDesignTimeHtml()	Предоставляет простое прямоугольное представление заполнителя, отображающее тип и идентификатор элемента управления. (Унаследовано от ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)	Предоставляет простое прямоугольное представление заполнителя, отображающее тип и идентификатор элемента управления, а также дополнительные инструкции или сведения. (Унаследовано от ControlDesigner)
CreateViewControl()	Возвращает копию связанного элемента управления для просмотра или отрисовки на поверхности конструктора. (Унаследовано от ControlDesigner)
Dispose()	Освобождает все ресурсы, используемые параметром ComponentDesigner. (Унаследовано от ComponentDesigner)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые HtmlControlDesigner объектом, и при необходимости освобождает управляемые ресурсы. (Унаследовано от HtmlControlDesigner)
DoDefaultAction()	Создает сигнатуру метода в файле исходного кода для события по умолчанию компонента и перемещает курсор пользователя в это расположение. (Унаследовано от ComponentDesigner)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetBounds()	Извлекает координаты прямоугольника, представляющего границы элемента управления, отображаемого на поверхности конструктора. (Унаследовано от ControlDesigner)
GetDesignTimeHtml()	Получает разметку, которая используется для представления связанного элемента управления во время разработки. (Унаследовано от TextControlDesigner)
GetDesignTimeHtml(DesignerRegionCollection)	Извлекает разметку HTML для отображения элемента управления и заполняет коллекцию текущими областями конструктора элементов управления. (Унаследовано от ControlDesigner)
GetEditableDesignerRegionContent(EditableDesignerRegion)	Возвращает содержимое редактируемой области представления времени разработки связанного элемента управления. (Унаследовано от ControlDesigner)
GetEmptyDesignTimeHtml()	Извлекает разметку HTML для представления элемента управления веб-сервера во время разработки, которое не будет визуального представления во время выполнения. (Унаследовано от ControlDesigner)
GetErrorDesignTimeHtml(Exception)	Извлекает разметку HTML, которая предоставляет сведения об указанном исключении. (Унаследовано от ControlDesigner)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetPersistenceContent()	Извлекает сохраняемую внутреннюю разметку HTML элемента управления во время разработки. (Унаследовано от ControlDesigner)
GetPersistInnerHtml()	Возвращает разметку, сохраняемую для внутренних тегов элемента управления. (Унаследовано от TextControlDesigner)
GetService(Type)	Пытается получить указанный тип службы из сайта режима конструктора компонента конструктора. (Унаследовано от ComponentDesigner)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetViewRendering()	Извлекает объект, содержащий разметку времени разработки для содержимого и регионов связанного элемента управления. (Унаследовано от ControlDesigner)
Initialize(IComponent)	Инициализирует конструктор с указанным компонентом. (Унаследовано от TextControlDesigner)
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)	Вызывается при изменении связанного элемента управления.
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)

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

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

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

Были ли сведения на этой странице полезными?

Поделиться через