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


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
Наследование
XhtmlControlAdapter
Производный
Атрибуты

Комментарии

Этот класс предоставляет базовый адаптер мобильного элемента управления, который отображает элемент управления и каждый из дочерних элементов в разметке XHTML для мобильных устройств. Он также предоставляет вспомогательные методы и общие свойства для производных адаптеров мобильных элементов управления XHTML.

Адаптеры управления — это компоненты, которые переопределяют определенные Control методы и события класса, чтобы разрешить обработку, зависящую от браузера или разметки. Большая часть адаптации в поведении отрисовки инкапсулируется в XhtmlTextWriter классе. Если вы рассматриваете, следует ли создавать собственный адаптер управления, имейте в виду, что один адаптер можно использовать для переопределения ряда поведения классов браузера. Кроме того, путем включения требуемой адаптации в класс, производный от XhtmlMobileTextWriter класса, можно устранить необходимость использования адаптера управления.

Адаптер для определенного класса управления применяется ко всем элементам управления, наследуемым от этого класса, если только не присутствуют более специализированные адаптеры. Например, XhtmlValidatorAdapter класс используется для проверки всех мобильных элементов управления для устройств, которым требуется или может отображать разметку XHTML.

Во время обработки платформа .NET Framework перехватывает вызовы методов элемента управления, относящееся к текущему целевому объекту. Если адаптер управления связан с элементом управления, платформа .NET Framework вызывает связанные методы адаптера.

Некоторые свойства элемента управления управляют тем, как он отображается на нескольких вторичных страницах для мобильного устройства. Эта страница называется дополнительным пользовательским интерфейсом. Свойство SecondaryUIMode можно использовать для определения страницы. Этот ExitSecondaryUIMode метод можно использовать для удаления любых дополнительных параметров пользовательского интерфейса.

Примечания для тех, кто наследует этот метод

При наследовании от XhtmlControlAdapter класса назовите адаптер для заданного типа элемента управления и языка разметки в шаблоне MarkupControlTypeAdapter (например, 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
Устаревшие..

Возвращает значение атрибута CssLocation , если оно существует, из формы, в которой он содержится. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

StyleSheetStorageApplicationSetting
Устаревшие..

Возвращает значение XhtmlCssState параметра конфигурации в appSettings разделе файла Web.config. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

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, String)
Устаревшие..

Записывает открывающий тег указанного элемента, а также атрибуты, реализующие форматирование макета и символов указанного стиля, если выполняются определенные условия. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

ConditionalEnterStyle(XhtmlMobileTextWriter, Style)
Устаревшие..

Записывает открывающий тег для <span> раздела, а также атрибуты, реализующие макет и форматирование символов указанного стиля, если выполняются определенные условия. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

ConditionalExitFormat(XhtmlMobileTextWriter, Style)
Устаревшие..

Завершает блок, использующий форматирование символов из заданного стиля, если выполняются определенные условия. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

ConditionalExitLayout(XhtmlMobileTextWriter, Style)
Устаревшие..

Завершает блок, который использовал форматирование макета из указанного стиля, если выполняются определенные условия. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

ConditionalExitStyle(XhtmlMobileTextWriter, Style)
Устаревшие..

</span> Заканчивает элемент, использующий макет и форматирование символов из заданного стиля, если выполняются определенные условия. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

ConditionalPopPhysicalCssClass(XhtmlMobileTextWriter)
Устаревшие..

Удаляет текущее каскадное имя класса таблицы стилей XhtmlMobileTextWriter из объекта, если выполнены определенные условия. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

ConditionalRenderClassAttribute(XhtmlMobileTextWriter)
Устаревшие..

Помещает атрибут имени класса в отрисовку следующего элемента, если выполняются определенные условия. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

ConditionalRenderClosingDivElement(XhtmlMobileTextWriter)
Устаревшие..

Отображает закрывающий </div> тег, если выполнены определенные условия. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

ConditionalRenderClosingSpanElement(XhtmlMobileTextWriter)
Устаревшие..

Отрисовывает закрывающий </span> элемент, если выполнены определенные условия. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

ConditionalRenderCustomAttribute(XhtmlMobileTextWriter, String, String)
Устаревшие..

Включает настраиваемый атрибут с указанным именем и значением в следующем элементе для отрисовки, если выполняются определенные условия. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

ConditionalRenderCustomAttribute(XhtmlMobileTextWriter, String)
Устаревшие..

Возвращает значение атрибута с указанным именем из связанного элемента управления и отображает его на следующем элементе с указанным именем, если выполняются определенные условия. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

ConditionalRenderOpeningDivElement(XhtmlMobileTextWriter)
Устаревшие..

Отображает открывающий тег для <div> элемента, если выполнены определенные условия. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

ConditionalRenderOpeningSpanElement(XhtmlMobileTextWriter)
Устаревшие..

Отображает открывающий тег для <span> элемента, если выполняются определенные условия. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

ConditionalSetPendingBreak(XhtmlMobileTextWriter)
Устаревшие..

Задает ожидающий разрыв, если выполнены определенные условия. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

ConditionalSetPendingBreakAfterInline(XhtmlMobileTextWriter)
Устаревшие..

Задает ожидающий разрыв после встроенных элементов, если выполнены определенные условия. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

CreateTemplatedUI(Boolean)
Устаревшие..

Вызывается элементом управления для создания шаблонного пользовательского интерфейса. Этот 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)
Устаревшие..

Возвращает значение true , если событие было обработано. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

(Унаследовано от ControlAdapter)
LoadAdapterState(Object)
Устаревшие..

Загружает данные состояния представления, относящиеся к этому адаптеру. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

LoadPostData(String, NameValueCollection, Object, Boolean)
Устаревшие..

Возвращает, true если адаптер обрабатывает загрузку данных после отправки. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

(Унаследовано от ControlAdapter)
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, String, Style, String, String)
Устаревшие..

Отрисовывает открывающий тег ссылки с помощью заданного XhtmlMobileTextWriter и целевого объекта, а также заданных стилей или заданного каскадного имени класса таблицы стилей, ключа доступа и текста заголовка. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

RenderBeginLink(XhtmlMobileTextWriter, String, String, Style, String)
Устаревшие..

Отрисовывает открывающий тег ссылки с помощью заданного и целевого, а также заданных XhtmlMobileTextWriter стилей или заданного каскадного имени класса таблицы стилей. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

RenderBeginLink(XhtmlMobileTextWriter, 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)
Устаревшие..

Отрисовывает закрывающий тег (</a>) для элемента ссылки. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

RenderOffPageVariables(XhtmlMobileTextWriter, Control, Int32)
Устаревшие..

Отрисовывает скрытые переменные обратной передачи для дочерних элементов управления, которые не отображаются из-за разбиения на страницы или дополнительного пользовательского интерфейса. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

RenderOpeningListTag(XhtmlMobileTextWriter, String)
Устаревшие..

Отображает открывающий тег для указанного имени тега. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

RenderPostBackEventAsAnchor(XhtmlMobileTextWriter, String, String, String, Style, String)
Устаревшие..

Отображает событие обратной передачи в виде ссылки с указанным аргументом, текстом и ключом доступа, а также указанными стилями или указанным каскадным именем класса таблицы стилей. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

RenderPostBackEventAsAnchor(XhtmlMobileTextWriter, String, String, String)
Устаревшие..

Отображает событие обратной передачи в виде ссылки с указанным аргументом, текстом и ключом доступа. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

RenderPostBackEventAsAnchor(XhtmlMobileTextWriter, String, String)
Устаревшие..

Отображает событие обратной передачи в виде ссылки с указанным аргументом и текстом. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

SaveAdapterState()
Устаревшие..

Сохраняет данные состояния представления, относящиеся к этому адаптеру. Этот API устарел. Сведения о разработке мобильных приложений ASP.NET см. в разделе мобильных приложений & сайтов с ASP.NET.

ToString()
Устаревшие..

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

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

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