WebControlAdapter Класс

Определение

Пространство имен:

System.Web.UI.WebControls.Adapters

Сборка:

System.Web.dll

Настраивает отрисовку веб-элементов управления, к которым прикреплен адаптер элемента управления, для изменения используемых по умолчанию разметки или поведения для конкретных браузеров.

public ref class WebControlAdapter : System::Web::UI::Adapters::ControlAdapter

public class WebControlAdapter : System.Web.UI.Adapters.ControlAdapter

type WebControlAdapter = class
    inherit ControlAdapter

Public Class WebControlAdapter
Inherits ControlAdapter

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

Object

ControlAdapter

WebControlAdapter

Производный

System.Web.UI.WebControls.Adapters.DataBoundControlAdapter

System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter

System.Web.UI.WebControls.Adapters.HierarchicalDataBoundControlAdapter

System.Web.UI.WebControls.Adapters.MenuAdapter

Комментарии

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

WebControlAdapterОбъект — это компонент, который заменяет определенный WebControl класс или унаследованные методы и события в жизненном цикле выполнения, чтобы обеспечить обработку, связанную с браузером или разметкой. платформа .NET Framework сопоставляет один адаптер элемента управления с производным WebControl объектом для каждого клиентского запроса.

Адаптер изменяет поведение элемента управления для конкретного браузера или класса браузеров или действует как произвольный фильтр для некоторых возможностей. Большая часть адаптируемости в процессе отрисовки может быть инкапсулирована в специализированные классы, производные от HtmlTextWriter класса. Таким образом, вполне вероятно, что один адаптер может использоваться для нескольких вариантов поведения класса браузера или что включение адаптируемости в HtmlTextWriter классы может сделать использование адаптера элемента управления ненужным.

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

Каждый элемент управления имеет явные сопоставления с адаптерами через файлы определения браузера. Таким словами, любой доступ к Adapter свойству WebControl использует HttpBrowserCapabilities объект, извлеченный из файлов определения браузера, для выполнения поиска сопоставления адаптера с контролем.

во время обработки платформа .NET Framework перехватывает вызовы переопределяемых методов элемента управления, которые могут быть зависят от целевого объекта. если адаптер элемента управления присоединен, платформа .NET Framework вызывает связанные методы адаптера. Для получения дополнительной информации см. ControlAdapter.

Отрисовка для, WebControl как правило, состоит из начального и конечного тегов и некоторой внутренней разметки между начальным и конечным тегами. Теги определяются при WebControl создании. Для получения дополнительной информации см. WebControl.

Теги создаются RenderBeginTag RenderEndTag методами и соответственно. Внутренняя разметка создается RenderContents методом.

RenderМетод создает всю разметку, вызывая методы в следующем порядке:

1. RenderBeginTag.

2. RenderContents.

3. RenderEndTag.

IsEnabledСвойство возвращает, true только если WebControl все его родительские элементы управления включены. ControlСвойство возвращает строго типизированную ссылку на WebControl .

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

WebControlAdapter()

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

Свойства

Browser	Возвращает ссылку на возможности клиентского браузера, создающего текущий HTTP-запрос. (Унаследовано от ControlAdapter)
Control	Возвращает ссылку на веб-элемент управления, к которому присоединен адаптер элемента управления.
IsEnabled	Возвращает значение, показывающее доступность веб-элемента управления и всех его родительских элементов управления.
Page	Возвращает ссылку на страницу, на которой располагается элемент управления, связанный с данным адаптером. (Унаследовано от ControlAdapter)
PageAdapter	Возвращает ссылку на адаптер страницы для страницы, на которой располагается связанный элемент управления. (Унаследовано от ControlAdapter)

Методы

BeginRender(HtmlTextWriter)	Вызывается до отрисовки элемента управления. В производном классе адаптеров генерируются открывающие теги, которые необходимы для определенной цели, но не требуются для HTML-браузеров. (Унаследовано от ControlAdapter)
CreateChildControls()	Создает целевые дочерние элементы управления для составного элемента управления. (Унаследовано от ControlAdapter)
EndRender(HtmlTextWriter)	Вызывается после отрисовки элемента управления. В производном классе адаптеров генерируются закрывающие теги, которые необходимы для определенной цели, но не требуются для HTML-браузеров. (Унаследовано от ControlAdapter)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
LoadAdapterControlState(Object)	Загружает сведения о состоянии адаптера элемента управления, которые были сохранены SaveAdapterControlState() во время предыдущего запроса страницы, на которой размещен элемент управления, связанный с адаптером элемента управления. (Унаследовано от ControlAdapter)
LoadAdapterViewState(Object)	Загружает сведения о состоянии просмотра адаптера, сохраненные объектом SaveAdapterViewState() во время предыдущего запроса страницы, на которой размещен элемент управления, связанный с адаптером элемента управления. (Унаследовано от ControlAdapter)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnInit(EventArgs)	Переопределяет метод OnInit(EventArgs) для связанного элемента управления. (Унаследовано от ControlAdapter)
OnLoad(EventArgs)	Переопределяет метод OnLoad(EventArgs) для связанного элемента управления. (Унаследовано от ControlAdapter)
OnPreRender(EventArgs)	Переопределяет метод OnPreRender(EventArgs) для связанного элемента управления. (Унаследовано от ControlAdapter)
OnUnload(EventArgs)	Переопределяет метод OnUnload(EventArgs) для связанного элемента управления. (Унаследовано от ControlAdapter)
Render(HtmlTextWriter)	Создает целевую разметку для элемента управления, к которому присоединяется адаптер управления.
RenderBeginTag(HtmlTextWriter)	Создает начальный тег веб-элемента управления в разметке для передачи в целевой браузер.
RenderChildren(HtmlTextWriter)	Создает целевую разметку для дочерних элементов управления в составном элементе управления, к которому присоединяется адаптер элемента управления. (Унаследовано от ControlAdapter)
RenderContents(HtmlTextWriter)	Создает для веб-элемента управления, к которому присоединен соответствующий адаптер, особую внутреннюю разметку, характерную для целевого объекта.
RenderEndTag(HtmlTextWriter)	Создает закрывающий тег веб-элемента управления в разметке для передачи в целевой браузер.
SaveAdapterControlState()	Сохраняет сведения о состоянии элемента управления для адаптера элемента управления. (Унаследовано от ControlAdapter)
SaveAdapterViewState()	Сохраняет сведения о состоянии просмотра для адаптера элемента управления. (Унаследовано от ControlAdapter)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

• ControlAdapter
• WebControl
• Control