XHTML-Adaptergruppe
Aktualisiert: November 2007
Die XHTML-Adaptergruppe gibt ASP.NET Mobile-Webseiten auf Clients wieder, die XHTML Basic und XHTML wiedergeben können, zum Beispiel Microsoft Internet Explorer für den Pocket PC.
In der folgenden Tabelle werden die Adaptergruppenklassen aufgeführt, wobei es sich um Eigenschaften handelt, die eine Klasse zurückgeben. Darüber hinaus werden die Hauptklassen aufgeführt, die in der XHTML-Adaptergruppe enthalten sind.
Adaptergruppenklasse oder Eigenschaft |
Hauptadapterklasse |
|---|---|
ControlAdapter (Basisklasse) |
|
Auswahl
Die XHTML-Adaptergruppe wird ausgewählt, wenn der bevorzugte Wiedergabetyp "xhtml-basic", "xhtml-mp" oder "wml20" ist.
.gif "Hinweis") Hinweis: |
|---|
In ASP.NET 2.0 sind die möglichen bevorzugten Wiedergabetypen für XHTML nicht Teil der MobileCapabilities-Klasse. |
Standardwiedergabe
Während der Standardwiedergabe der Seiten- und der Formularadapterklassen in der XHTML-Adaptergruppe werden die folgenden Schritte vom Seitenadapter ausgeführt.
Ruft die BeginResponse-Methode und die BeginFile-Methode für den Writer auf. Der Inhaltstyp ist auf "text/html" festgelegt.
Schreibt eine XML-Deklaration (<? xml version=1.0 encoding="encodingType" ?>).
Schreibt den DTD-Verweis für das XHTML-Dokument.
Schreibt ein öffnendes <html xmlns="http://www.w3.org/1999/xhtml" >-Tag.
Gibt das aktive Formular wieder.
Schreibt ein schließendes </html>-Tag.
Ruft die EndFile-Methode und die EndResponse-Methode auf.
Der Formularadapter führt folgende Schritte aus:
Schreibt ein öffnendes title-Element, wenn dieses benötigt wird.
Schreibt das öffnende <body>-Tag und das <form>-Tag.
Schreibt ausgeblendete und interne Formularvariablen sowie Scripts für Postback.
Gibt die Formularinhalte wieder.
Schreibt schließende </form>-Tags und </body>-Tags.
Verwenden von Stilen
Die XhtmlMobileTextWriter-Klasse stellt die folgenden Hilfsmethoden bereit, die bei der Verwendung von Stilinformationen helfen, um Aspekte für die Darstellung von Zeichen oder Layout zu steuern.
Die EnterFormat-Methode und die ExitFormat-Methode begrenzen einen Zeichenformatierungsblock.
Die EnterLayout-Methode und die ExitLayout-Methode begrenzen einen Block von Ausrichtungs- und Umbruchslayout.
Die EnterStyle-Methode und die ExitStyle-Methode begrenzen einen Block von Zeichenformatierung mit Ausrichtungs- und Umbruchslayout.
Eine Reihe von Eigenschaften bestimmen, welche Stileigenschaften geschrieben werden. Diese Eigenschaften (z. B. RenderBold, RenderItalic usw.) werden festgelegt, wenn der Writer mithilfe der Gerätefunktionen des anfordernden Geräts erstellt wird.
Der breakAfter-Parameter der ExitLayout-Methode, der ExitFormat-Methode und der ExitStyle-Methode steuert, ob nach den Tags für Format und Layout ein Umbruch eingefügt wird. Wenn Sie den breakAfter-Parameter auf true festlegen, wird bei der Ausgabe mit einem br oder einem div-Element ein logischer Umbruch wiedergegeben.
Wiedergabe von Postback-Steuerelementen
Standardmäßig werden Postback-Steuerelemente in Formularen als Schaltflächen wiedergegeben. Um eine Verknüpfung als Postback-Steuerelement zu verwenden, können Sie die RenderPostBackEventAsAnchor-Methode der XhtmlControlAdapterBasisklasse aufrufen. Diese Methode gibt ein a-Element wieder, das das Formular zurücksendet, wenn der Benutzer auf die Verknüpfung klickt.
Sie können ein Postback-Steuerelement auch erstellen, indem Sie ein Attribut von anderen Elementen für einen Steuerelementadapter festlegen. Rufen Sie dazu die RenderPostBackEventAsAttribute-Methode auf. Zum Beispiel können Sie die Methode verwenden, um für eine Schaltfläche ein onClick-Attribut zu erstellen.
Wiedergabe von Verknüpfungen
Verknüpfungen zu anderen Seiten werden als Hyperlinks wiedergegeben. Verknüpfungen zu anderen Formularen auf derselben Seite werden als Postback-Steuerelemente wiedergegeben.
Um eine Verknüpfung für einen mobilen Steuerelementadapter wiederzugeben, können Sie die RenderBeginLink-Methode und die RenderEndLink-Methode der XhtmlControlAdapter-Basisklasse aufrufen. Die RenderBeginLink-Methode überprüft automatisch den Verknüpfungstyp und gibt das entsprechende Markup wieder.
Sekundäre Benutzeroberfläche
Die XHTML-Adaptergruppe unterstützt das Konzept der sekundären Benutzeroberfläche. Steuerelemente zeigen damit zusätzliche Bildschirme der Benutzeroberfläche an. Ein Steuerelementadapter führt folgende Schritte zum Verwenden einer sekundären Benutzeroberfläche aus:
Als Reaktion auf eine Benutzerinteraktion (üblicherweise in der überschreibbaren HandlePostBackEvent-Methode) gibt der Steuerelementadapter den Modus für die sekundäre Benutzeroberfläche an, indem er die SecondaryUIMode-Eigenschaft der XhtmlControlAdapter-Basisklasse auf eine intern bekannte Konstante festlegt.
Bei der Wiedergabe überprüft das Steuerelement, ob es sich im Modus für die sekundäre Benutzeroberfläche befindet. Wenn dies der Fall ist, wird die entsprechende sekundäre Benutzeroberfläche wiedergegeben.
Der Steuerelementadapter kann als Reaktion auf eine Benutzerinteraktion in der sekundären Benutzeroberfläche den Modus für die sekundäre Benutzeroberfläche auf einen anderen Wert ändern oder diesen Modus durch Aufruf der ExitSecondaryUIMode-Methode der XhtmlControlAdapter-Basisklasse beenden.