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.

Теги создаются RenderBeginTagRenderEndTag соответствующими методами. Внутренняя разметка создается методом 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