XhtmlControlAdapter Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Внимание!
The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.
Предоставляет заданный по умолчанию адаптер элементов управления для отрисовки мобильных элементов управления в XHTML-разметке. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET.
public ref class XhtmlControlAdapter : System::Web::UI::MobileControls::Adapters::ControlAdapter
public class XhtmlControlAdapter : System.Web.UI.MobileControls.Adapters.ControlAdapter
[System.Obsolete("The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.")]
public class XhtmlControlAdapter : System.Web.UI.MobileControls.Adapters.ControlAdapter
type XhtmlControlAdapter = class
inherit ControlAdapter
[<System.Obsolete("The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.")>]
type XhtmlControlAdapter = class
inherit ControlAdapter
Public Class XhtmlControlAdapter
Inherits ControlAdapter
- Наследование
- Производный
- Атрибуты
Комментарии
Этот класс предоставляет базовый адаптер мобильного элемента управления, который отрисовывает элемент управления и все его дочерние элементы в разметке XHTML для мобильных устройств. Он также предоставляет вспомогательные методы и общие свойства для производных адаптеров мобильных элементов управления XHTML.
Адаптеры управления — это компоненты, которые переопределяют определенные Control методы и события класса, чтобы разрешить обработку для конкретного браузера или разметки. Большая часть адаптивности в поведении отрисовки инкапсулируется в XhtmlTextWriter классе . Если вы рассматриваете возможность создания собственного адаптера управления, помните, что один адаптер можно использовать для переопределения ряда поведений класса браузера. Кроме того, включив требуемую адаптивность в класс, производный XhtmlMobileTextWriter от класса , можно исключить необходимость использования адаптера управления.
Адаптер для определенного класса элементов управления применяется ко всем элементам управления, наследующим от этого класса, если нет более специализированных адаптеров. Например, XhtmlValidatorAdapter класс используется для проверки всех мобильных элементов управления для устройств, которым требуется или может отображаться разметка XHTML.
Во время обработки .NET Framework перехватывает вызовы методов элемента управления, относящихся к текущему целевому объекту. Если адаптер элемента управления связан с элементом управления, платформа .NET Framework вызывает связанные методы адаптера.
Некоторые свойства элемента управления управляют способом его отображения на нескольких дополнительных страницах для мобильного устройства. Эти страницы называются дополнительным пользовательским интерфейсом. Свойство SecondaryUIMode можно использовать для определения отображаемой страницы. Метод ExitSecondaryUIMode можно использовать для удаления любых дополнительных параметров пользовательского интерфейса.
Примечания для тех, кто наследует этот метод
При наследовании от XhtmlControlAdapter класса присвойте адаптеру имя для заданного типа элемента управления и языка разметки в шаблоне MarkupControlType
Adapter
(например, XhtmlTextBoxAdapter). Адаптеры для элемента управления, предоставляющего разметку XHTML, должны быть реализованы System.Web.UI.MobileControls.Adapters.XhtmlAdapters в пространстве имен.
Все специализированные адаптеры должны быть определены для специализированного элемента управления в каждом узле устройства в файлах конфигурации .browser.
Правильно реализованный элемент управления не должен предполагать, что адаптер подключен или что подключенный адаптер реализует определенный интерфейс. Вместо этого следует проверить наличие этих условий.
Ряд методов условной отрисовки позволяют выполнять такие условия, как дополнительный пользовательский интерфейс и устройства отображения, которым требуются разрывы строк после каждого блока или после каждого встроенного элемента управления. Примерами этих условных методов являются ConditionalSetPendingBreak(XhtmlMobileTextWriter) и ConditionalEnterLayout(XhtmlMobileTextWriter, Style). Эти методы работают для конкретного устройства независимо от элемента управления, отображаемого. Маловероятно, что вам потребуется переопределить эти методы при создании нового адаптера управления на основе этого класса. Как минимум необходимо переопределить Render методы.
Фильтрация устройств необходима для использования определенного адаптера для серверного элемента управления. Дополнительные сведения о фильтрации устройств см. в разделах Обзор архитектуры поведения адаптивного элемента управления и Обзор фильтрации устройств.
Конструкторы
XhtmlControlAdapter() |
Устаревшие..
Создает новый экземпляр класса XhtmlControlAdapter. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
Поля
NotSecondaryUI |
Устаревшие..
Значение, возвращаемое свойством SecondaryUIMode, показывающее, что адаптер в данный момент не находится в режиме дополнительного пользовательского интерфейса. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
Свойства
Control |
Устаревшие..
Возвращает строго типизированную ссылку на связанный элемент управления. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. (Унаследовано от ControlAdapter) |
CssLocation |
Устаревшие..
Указывает, располагается ли таблица стилей как внешний физический файл, является ли она внутренней для текущей страницы, хранится ли она в текущем состоянии сеанса или в кэше приложения. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
Device |
Устаревшие..
Возвращает объект возможностей устройства, связанный с запросом. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. (Унаследовано от ControlAdapter) |
DocumentType |
Устаревшие..
Указывает тип XHTML-разметки, используемой для визуализации текущего документа. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
ItemWeight |
Устаревшие..
Осуществляет доступ к примерному весу единичного элемента в элементе управления. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. (Унаследовано от ControlAdapter) |
Page |
Устаревшие..
Возвращает страницу, сопоставленную с адаптером устройства. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. (Унаследовано от ControlAdapter) |
PageAdapter |
Устаревшие..
Получает адаптер страницы для страницы, на которой располагается связанный элемент управления. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
SecondaryUIMode |
Устаревшие..
Получает текущий режим дополнительного пользовательского интерфейса. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
Style |
Устаревшие..
Возвращает объект стиля, связанный с элементом управления, которому назначен данный адаптер устройства. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. (Унаследовано от ControlAdapter) |
StyleSheetLocationAttributeValue |
Устаревшие..
Получает значение атрибута |
StyleSheetStorageApplicationSetting |
Устаревшие..
Получает значение параметра конфигурации |
VisibleWeight |
Устаревшие..
Получает или задает примерный вес элемента управления (в символах). Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. (Унаследовано от ControlAdapter) |
Методы
CalculateOptimumPageWeight(Int32) |
Устаревшие..
Определяет оптимальный вес страницы для устройства. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. (Унаследовано от ControlAdapter) |
ClearPendingBreakIfDeviceBreaksOnBlockLevel(XhtmlMobileTextWriter) |
Устаревшие..
Очищает отложенные разрывы, если целевое устройство разрывает блок-элементы. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
ConditionalClearCachedEndTag(XhtmlMobileTextWriter, String) |
Устаревшие..
Очищает заданный модулем записи текста текущий закрывающий тег при соблюдении определенных условий. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
ConditionalClearPendingBreak(XhtmlMobileTextWriter) |
Устаревшие..
Очищает отложенные разрывы на целевом устройстве при соблюдении определенных условий. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
ConditionalEnterFormat(XhtmlMobileTextWriter, Style) |
Устаревшие..
Начинает раздел с открывающего тега и атрибутов, которые реализуют форматы указанного стиля при соблюдении определенных условий. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
ConditionalEnterLayout(XhtmlMobileTextWriter, Style) |
Устаревшие..
Начинает раздел с открывающего тега и атрибутов, которые реализуют макет указанного стиля при соблюдении определенных условий. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
ConditionalEnterStyle(XhtmlMobileTextWriter, Style) |
Устаревшие..
Записывает открывающий тег для раздела |
ConditionalEnterStyle(XhtmlMobileTextWriter, Style, String) |
Устаревшие..
Записывает открывающий тег определенного элемента вместе с атрибутами, которые реализуют макет и форматирование символов указанного стиля при соблюдении определенных условий. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
ConditionalExitFormat(XhtmlMobileTextWriter, Style) |
Устаревшие..
При соблюдении определенных условий завершает блок, который использовал метод форматирования символов из заданного стиля. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
ConditionalExitLayout(XhtmlMobileTextWriter, Style) |
Устаревшие..
При соблюдении определенных условий завершает блок, который использовал метод форматирования макета из заданного стиля. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
ConditionalExitStyle(XhtmlMobileTextWriter, Style) |
Устаревшие..
При соблюдении определенных условий завершает элемент |
ConditionalPopPhysicalCssClass(XhtmlMobileTextWriter) |
Устаревшие..
При соблюдении определенных условий удаляет имя класса текущей каскадной таблицы стилей из объекта XhtmlMobileTextWriter. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
ConditionalRenderClassAttribute(XhtmlMobileTextWriter) |
Устаревшие..
Помещает атрибут имени класса в следующий визуализируемый элемент при соблюдении определенных условий. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
ConditionalRenderClosingDivElement(XhtmlMobileTextWriter) |
Устаревшие..
При соблюдении определенных условий выполняет визуализацию закрывающего тега |
ConditionalRenderClosingSpanElement(XhtmlMobileTextWriter) |
Устаревшие..
При соблюдении определенных условий выполняет визуализацию закрывающего элемента |
ConditionalRenderCustomAttribute(XhtmlMobileTextWriter, String) |
Устаревшие..
Получает значение атрибута с указанным именем из связанного элемента управления и отображает его в следующем элементе с указанным именем при соблюдении определенных условий. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
ConditionalRenderCustomAttribute(XhtmlMobileTextWriter, String, String) |
Устаревшие..
Включает пользовательский атрибут с указанным именем и значением в следующий визуализируемый элемент при соблюдении определенных условий. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
ConditionalRenderOpeningDivElement(XhtmlMobileTextWriter) |
Устаревшие..
При соблюдении определенных условий выполняет визуализацию открывающего тега для элемента |
ConditionalRenderOpeningSpanElement(XhtmlMobileTextWriter) |
Устаревшие..
При соблюдении определенных условий выполняет визуализацию открывающего тега для элемента |
ConditionalSetPendingBreak(XhtmlMobileTextWriter) |
Устаревшие..
Задает отложенный разрыв при соблюдении определенных условий. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
ConditionalSetPendingBreakAfterInline(XhtmlMobileTextWriter) |
Устаревшие..
Задает отложенный разрыв после встроенных элементов при соблюдении определенных условий. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
CreateTemplatedUI(Boolean) |
Устаревшие..
Вызывается элементом управления для создания шаблонного пользовательского интерфейса (UI). Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. (Унаследовано от ControlAdapter) |
Equals(Object) |
Устаревшие..
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
ExitSecondaryUIMode() |
Устаревшие..
Выходит из любых режимов дополнительного пользовательского интерфейса для элемента управления. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
GetCustomAttributeValue(MobileControl, String) |
Устаревшие..
Получает значение определенного атрибута из указанного элемента управления. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
GetCustomAttributeValue(String) |
Устаревшие..
Получает значение определенного атрибута из разметки связанного элемента управления. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
GetDefaultLabel(Int32) |
Устаревшие..
Возвращает локализованную строку по умолчанию для элемента управления "Метка". Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. (Унаследовано от ControlAdapter) |
GetHashCode() |
Устаревшие..
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetType() |
Устаревшие..
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
HandlePostBackEvent(String) |
Устаревшие..
Возвращает |
LoadAdapterState(Object) |
Устаревшие..
Загружает данные состояния просмотра, специфичные для этого адаптера. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
LoadPostData(String, NameValueCollection, Object, Boolean) |
Устаревшие..
Возвращает |
MemberwiseClone() |
Устаревшие..
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
OnInit(EventArgs) |
Устаревшие..
Вызывается после инициализации объекта, например формы или страницы. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. (Унаследовано от ControlAdapter) |
OnLoad(EventArgs) |
Устаревшие..
Загружает данные, относящиеся к элементу управления, странице или адаптеру устройств. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. (Унаследовано от ControlAdapter) |
OnPreRender(EventArgs) |
Устаревшие..
Вызывается методом OnPreRender(EventArgs) элемента управления, чтобы выполнить перед отрисовкой действие, специфичное в зависимости от адаптера. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. (Унаследовано от ControlAdapter) |
OnUnload(EventArgs) |
Устаревшие..
Выгружает данные, относящиеся к элементу управления, странице или адаптеру устройства. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. (Унаследовано от ControlAdapter) |
PreprocessQueryString(String) |
Устаревшие..
Получает ту часть указанной строки запроса, которая содержит параметры для обработки запроса. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
Render(HtmlTextWriter) |
Устаревшие..
Отображает связанный элемент управления и все его дочерние элементы управления на стороне клиента. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
Render(XhtmlMobileTextWriter) |
Устаревшие..
Отображает связанный элемент управления и все его дочерние элементы управления на стороне клиента. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
RenderAsHiddenInputField(XhtmlMobileTextWriter) |
Устаревшие..
Отрисовывает текст скрытого поля для элемента управления. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
RenderBeginLink(XhtmlMobileTextWriter, String) |
Устаревшие..
Выполняет визуализацию открывающего тега ссылки, используя указанные объект XhtmlMobileTextWriter и целевой объект. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
RenderBeginLink(XhtmlMobileTextWriter, String, String, Style, String) |
Устаревшие..
Выполняет визуализацию открывающего тега ссылки, используя указанные объект XhtmlMobileTextWriter и целевой объект, а также указанные стили или указанное имя класса каскадной таблицы стилей. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
RenderBeginLink(XhtmlMobileTextWriter, String, String, Style, String, String) |
Устаревшие..
Выполняет визуализацию открывающего тега ссылки, используя указанные объект XhtmlMobileTextWriter и целевой объект, а также указанные стили или имя класса каскадной таблицы стилей, клавишу доступа и текст заголовка. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
RenderChildren(HtmlTextWriter) |
Устаревшие..
Выполняет визуализацию дочерних элементов управления. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. (Унаследовано от ControlAdapter) |
RenderClosingListTag(XhtmlMobileTextWriter, String) |
Устаревшие..
Выполняет визуализацию закрывающего тега для заданного элемента списка. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
RenderEndLink(XhtmlMobileTextWriter) |
Устаревшие..
Выполняет визуализацию закрывающего тега ( |
RenderOffPageVariables(XhtmlMobileTextWriter, Control, Int32) |
Устаревшие..
Выполняет визуализацию скрытых переменных обратной передачи для дочерних элементов управления, невидимых из-за разбиения на страницы или дополнительного пользовательского интерфейса. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
RenderOpeningListTag(XhtmlMobileTextWriter, String) |
Устаревшие..
Выполняет визуализацию открывающего тега с указанным именем. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
RenderPostBackEventAsAnchor(XhtmlMobileTextWriter, String, String) |
Устаревшие..
Выполняет визуализацию события обратной передачи в виде ссылки с указанными аргументом и текстом. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
RenderPostBackEventAsAnchor(XhtmlMobileTextWriter, String, String, String) |
Устаревшие..
Выполняет визуализацию события обратной передачи в виде ссылки с указанными аргументом, текстом и клавишей доступа. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
RenderPostBackEventAsAnchor(XhtmlMobileTextWriter, String, String, String, Style, String) |
Устаревшие..
Выполняет визуализацию события обратной передачи в виде ссылки с указанными аргументом, текстом и клавишей доступа, а также с указанными стилями или заданным именем класса таблицы каскадных стилей. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
SaveAdapterState() |
Устаревшие..
Сохраняет данные о состояния просмотра, специфичные для этого адаптера. Этот API устарел. Сведения о разработке ASP.NET мобильных приложений см. в статье Мобильные приложения & сайты с ASP.NET. |
ToString() |
Устаревшие..
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |