Ensemble d'adaptateurs HTML
Mise à jour : novembre 2007
L'ensemble d'adaptateurs HTML affiche les pages Web mobiles ASP.NET sur les clients qui gèrent le rendu HTML 3.2 et l'activation des scripts, par exemple Microsoft Internet Explorer pour Pocket PC.
Le tableau suivant répertorie les classes principales incluses dans l'ensemble d'adaptateurs HTML.
Ensemble d'adaptateurs |
Espace de noms de la classe d'adaptateur principale |
|---|---|
Classe de base abstraite ControlAdapter |
|
HtmlControlAdapter, classe |
|
Classe abstraite PageAdapter |
|
MobileTextWriter, classe |
Sélection
L'ensemble d'adaptateurs HTML est sélectionné si la propriété PreferredRenderingType de la classe MobileCapabilities retourne PreferredRenderingTypeHtml32 et la propriété JavaScript de la classe de fonctionnalités de navigateur retourne true.
Rendu par défaut
La liste suivante répertorie le rendu par défaut des classes d'adaptateur de page et de formulaire dans l'ensemble d'adaptateurs HTML.
L'adaptateur de page exécute les étapes suivantes :
Appelle les méthodes BeginResponse et BeginFile sur le writer. Le type de contenu est text/html.
Écrit une balise d'ouverture <html>.
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>, si nécessaire.
Écrit les balises <body> et <form>.
Écrit des variables de formulaire masquées et internes, puis publie le script.
Affiche le contenu du formulaire.
Écrit les balises de fermeture </form> et </body>.
Utilisation des styles
La classe HtmlMobileTextWriter fournit un certain nombre de méthodes d'assistance qui facilitent l'utilisation des informations de style, afin de contrôler 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 contrôlent 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(Style, Boolean), ExitFormat(Style, Boolean) et ExitStyle(Style, Boolean) contrôle si un saut de ligne doit être inséré après les balises de format et de disposition. Si ce paramètre a la valeur true, un saut de ligne logique s'affiche dans la sortie via l'utilisation d'un élément <br> ou <div>.
Rendu des publications
Les publications de formulaire sont rendues sous forme d'appels à un script client écrit avec le formulaire.
Pour afficher un événement de publication sous forme d'ancre pour un adaptateur, vous pouvez appeler la méthode RenderPostBackEventAsAnchor de la classe de base HtmlControlAdapter. Cette méthode écrit une balise <a> et génère une publication lorsque l'utilisateur clique sur le lien.
Pour afficher un événement de publication en tant qu'attribut d'une autre balise pour un adaptateur de contrôle, vous pouvez appeler la méthode RenderPostBackEventAsAttribute. Vous pouvez utiliser cette méthode dans le cadre d'autres balises ; par exemple, vous pouvez l'utiliser 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 publications de formulaire.
Pour afficher un lien d'adaptateur de contrôle mobile, vous pouvez appeler les méthodes RenderBeginLink et RenderEndLink de la classe de base HtmlControlAdapter. La méthode RenderBeginLink vérifie automatiquement le type du lien et affiche le balisage approprié.
Interface utilisateur secondaire
L'ensemble d'adaptateurs HTML prend en charge un concept appelé interface utilisateur secondaire. L'interface utilisateur secondaire est utilisée par les contrôles qui affichent les écrans supplémentaires d'une 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 définissant la propriété SecondaryUIMode de la classe de base HtmlControlAdapter.
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 HtmlControlAdapter.