HiddenFieldDesigner Класс

Определение

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

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

Важно!

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

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

public ref class HiddenFieldDesigner : System::Web::UI::Design::ControlDesigner

public class HiddenFieldDesigner : System.Web.UI.Design.ControlDesigner

type HiddenFieldDesigner = class
    inherit ControlDesigner

Public Class HiddenFieldDesigner
Inherits ControlDesigner

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

ComponentDesigner

HtmlControlDesigner

ControlDesigner
HiddenFieldDesigner

Примеры

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

Пример является производным MyHiddenField элементом HiddenFieldуправления от элемента управления. HiddenFieldКопия MyHiddenField . В примере также наследуется MyHiddenFieldDesigner класс из HiddenFieldDesigner класса и применяется DesignerAttribute атрибут для MyHiddenFieldDesignerMyHiddenField элемента управления.

Метод MyHiddenFieldDesigner переопределяет GetDesignTimeHtml метод для создания заполнителя, включающего Value свойство в заполнитель, а также имя класса элемента управления и ID свойство.

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 MyHiddenField is a copy of the HiddenField.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.MyHiddenFieldDesigner))]
    public class MyHiddenField : HiddenField
    {
    } // MyHiddenField

    // Derive a designer that inherits from the HiddenFieldDesigner.
    public class MyHiddenFieldDesigner : HiddenFieldDesigner
    {
        // Generate the design-time markup.
        public override string GetDesignTimeHtml()
        {
            // Get a reference to the control or a copy of the control.
            MyHiddenField myHF = (MyHiddenField)ViewControl;

            // Create a placeholder that displays the control value.
            string markup = CreatePlaceHolderDesignTimeHtml(
                 "Value: \"" + myHF.Value.ToString() + "\"" );

            return markup;
        } // GetDesignTimeHtml
    } // MyHiddenFieldDesigner
} // Examples.CS.WebControls.Design

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

Namespace Examples.VB.WebControls.Design

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

    ' Derive a designer that inherits from the HiddenFieldDesigner.
    Public Class MyHiddenFieldDesigner
        Inherits HiddenFieldDesigner

        ' Generate the design-time markup.
        Public Overrides Function GetDesignTimeHtml() As String

            ' Get a reference to the control or a copy of the control.
            Dim myHF As MyHiddenField = CType(ViewControl, MyHiddenField)

            Dim markup As String = _
                CreatePlaceHolderDesignTimeHtml( _
                    "Value: """ & myHF.Value.ToString() & """" )

            Return markup

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

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

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

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

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

Свойства

Имя	Описание
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()	Получает разметку, которая используется для отрисовки связанного элемента управления во время разработки.
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)
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)

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

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

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

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