Ensemble d'adaptateurs XHTML
Mise à jour : novembre 2007
L'ensemble d'adaptateurs XHTML affiche les pages Web mobiles ASP.NET sur les clients qui gèrent le rendu XHTML Basic et XHTML, par exemple Microsoft Internet Explorer pour Pocket PC.
Le tableau suivant répertorie les classes de l'ensemble d'adaptateurs, une propriété qui retourne une classe, et les classes principales qui sont incluses dans l'ensemble d'adaptateurs XHTML.
Classe ou propriété de l'ensemble d'adaptateurs |
Classe d'adaptateur principale |
|---|---|
(Classe de base) ControlAdapter |
|
Sélection
L'ensemble d'adaptateurs XHTML est sélectionné si le type de rendu par défaut est "xhtml-basic", "xhtml-mp" ou "wml20".
.gif "Remarque") Remarque : |
|---|
Dans ASP.NET 2.0, les types de rendu par défaut possibles pour XHTML ne font pas partie de la classe MobileCapabilities. |
Rendu par défaut
Lors du rendu par défaut des classes d'adaptateur de page et de formulaire dans l'ensemble d'adaptateurs XHTML, l'adaptateur de page effectue les étapes suivantes.
Appelle les méthodes BeginResponse et BeginFile du writer. Le type de contenu a la valeur "text/html".
Écrit une déclaration XML (<? xml version=1.0 encoding="encodingType" ?>).
Écrit la référence DTD du document XHTML.
Écrit une balise d'ouverture <html xmlns="http://www.w3.org/1999/xhtml" >.
Affiche le formulaire actif.
Écrit une balise de fermeture </html>.
Appelle les méthodes EndFile et EndResponse.
L'adaptateur de formulaire exécute les étapes suivantes :
Écrit un élément title d'ouverture, si nécessaire.
Écrit les balises d'ouverture <body> et <form>.
Écrit toutes les variables de formulaire masquées et internes, ainsi que le script de publication.
Affiche le contenu du formulaire.
Écrit les balises de fermeture </form> et </body>.
Utilisation des styles
La classe XhtmlMobileTextWriter fournit les méthodes d'assistance suivantes qui facilitent l'utilisation des informations de style, afin de contrôler les aspects liés à l'apparence des caractères ou à la présentation :
Les méthodes EnterFormat et ExitFormat délimitent un bloc de mise en forme des caractères.
Les méthodes EnterLayout et ExitLayout délimitent un bloc d'alignement et d'habillage.
Les méthodes EnterStyle et ExitStyle délimitent un bloc de mise en forme des caractères, d'alignement et d'habillage.
Un certain nombre de propriétés déterminent les propriétés de style qui sont écrites. Ces propriétés (par exemple RenderBold, RenderItalic, etc.) sont définies lors de la création du writer, à partir des fonctionnalités du périphérique à l'origine de la demande.
Le paramètre breakAfter des méthodes ExitLayout, ExitFormat et ExitStyle contrôle si un saut de ligne doit être inséré après les balises de format et de disposition. Si le paramètre breakAfter a la valeur true, un saut de ligne logique est restitué dans la sortie à l'aide d'un élément br ou div.
Rendu de contrôles de publication
Par défaut, les contrôles de publication de formulaire sont restitués sous forme de boutons. Pour utiliser un lien comme contrôle de publication, vous pouvez appeler la méthode RenderPostBackEventAsAnchor de la classe de base XhtmlControlAdapter. Cette méthode restitue un élément a qui publie (postback) le formulaire lorsque l'utilisateur clique sur le lien.
Vous pouvez également créer un contrôle de publication en définissant un attribut d'autres éléments pour un adaptateur de contrôle. Pour ce faire, vous pouvez appeler la méthode RenderPostBackEventAsAttribute. Par exemple, vous pouvez utiliser la méthode pour créer un attribut onClick pour un bouton.
Rendu des liens
Les liens vers d'autres pages sont rendus en tant que liens hypertexte. Les liens vers d'autres formulaires de la même page sont rendus en tant que contrôles de publication.
Pour afficher un lien d'adaptateur de contrôle mobile, vous pouvez appeler les méthodes RenderBeginLink et RenderEndLink de la classe de base XhtmlControlAdapter. La méthode RenderBeginLink vérifie automatiquement le type du lien et affiche le balisage approprié.
Interface utilisateur secondaire
L'ensemble d'adaptateurs XHTML prend en charge l'interface utilisateur secondaire qui est utilisée par les contrôles pour afficher les écrans supplémentaires de l'interface utilisateur. Pour utiliser l'interface utilisateur secondaire, un adaptateur de contrôle exécute les étapes suivantes :
En réponse à une intervention de l'utilisateur (généralement dans la méthode HandlePostBackEvent substituable), l'adaptateur de contrôle spécifie le mode interface utilisateur secondaire en affectant à la propriété SecondaryUIMode de la classe de base XhtmlControlAdapter une constante connue de manière interne.
Lors du rendu, le contrôle vérifie s'il se trouve en mode interface utilisateur secondaire et, si tel est le cas, affiche l'interface utilisateur secondaire appropriée.
En réponse à l'intervention de l'utilisateur à partir de l'interface utilisateur secondaire, l'adaptateur de contrôle peut remplacer le mode interface utilisateur secondaire par une autre valeur ; sinon, il peut quitter le mode interface utilisateur secondaire en appelant la méthode ExitSecondaryUIMode de la classe de base XhtmlControlAdapter.