Form, contrôle

Article
04/11/2008

En tant que conteneur d'un nombre illimité de contrôles, le contrôle Form représente également le regroupement de contrôles le plus éloigné dans un objet MobilePage. Un formulaire contient généralement plusieurs contrôles ; par conséquent, vous pouvez le considérer comme un ensemble de contrôles adressables séparément et accessibles à partir de l'application.

Lorsque plusieurs contrôles se trouvent sur un formulaire individuel, ASP.NET sépare ces contrôles en plusieurs unités pour le périphérique cible approprié. Cependant, dans la mesure où un formulaire est considéré comme une unité de discours distincte (un ensemble de contrôles adressables séparément), ASP.NET ne combine jamais plusieurs formulaires sur un seul écran.

Syntaxe des contrôles mobiles

Les propriétés, valeurs par défaut et éléments de code requis sont indiqués en caractères gras.

<mobile:Formrunat="server"
   id="id"
   Font-Name="fontName"
   Font-Size="{NotSet|Normal|Small|Large}"
   Font-Bold="{NotSet|False|True}"
   Font-Italic="{NotSet|False|True}"
   ForeColor="foregroundColor"
   BackColor="backgroundColor"
   Alignment="{NotSet|Left|Center|Right}"
   StyleReference="styleReference"
   Wrapping="{NotSet|Wrap|NoWrap}"

   Action="url"
   Method="{Post|Get}"
   OnActivate="activateHandler"
   OnDeactivate="deactivateHandler"
   OnPaginate=changeHandler"
   Paginate="{True|False}"
   Title="formTitle">
Place child controls here. (optional)
</mobile:Form>

Règles relatives à la relation contenant-contenu

Les contrôles suivants peuvent contenir un contrôle Form.

Contrôle	Commentaires
System.Web.UI.MobileControls.MobilePage	Doit contenir un ou plusieurs contrôles Form.

Un contrôle Form peut contenir les contrôles ci-dessous.

Contrôle	Commentaires
Tous les membres de System.Web.UI.MobileControls, sauf les objets MobilePage, Form et StyleSheet.	Les formulaires peuvent contenir n'importe quel autre contrôle mobile ASP.NET, sauf des formulaires ou des feuilles de style. Les formulaires doivent contenir un ou plusieurs des contrôles décrits dans la colonne Contrôle.

Modèles de périphériques

Pour plus d'informations sur la façon de spécifier les modèles suivants, consultez l'élément <DeviceSpecific> ou <Choice>.

Modèle	Description
En-tête	Le modèle d'en-tête est rendu au début du formulaire. En mode paginé, l'en-tête est rendu sur chaque page.
Pied de page	Le modèle de pied de page est rendu à la fin du formulaire. En mode paginé, le pied de page est rendu sur chaque page.
Script	Le modèle de script est rendu en haut du formulaire. Si le formulaire est paginé sur plusieurs écrans, chacun d'eux contient le modèle de script. Le code contenu dans le modèle de script est ajouté directement après la balise d'ouverture <head> sur les périphériques HTML, et directement après la balise d'ouverture <card> sur les périphériques WML.

Les modèles d'en-tête et de pied de page peuvent faire partie d'un ensemble de modèles indépendant du périphérique. Si l'ensemble de modèles est indépendant du périphérique, les modèles doivent contenir des contrôles mobiles.

Comportement spécifique au périphérique

Si des propriétés de style sont définies dans un contrôle Form contenant des contrôles individuels en cascade, tout comportement spécifique au périphérique et applicable aux contrôles individuels est appliqué aux propriétés de style.

Pour les périphériques qui prennent en charge l'utilisation de la touche TABULATION pour passer d'un contrôle à un autre, l'ordre de tabulation est défini soit par l'ordre d'affichage des contrôles sur la page, soit par l'ordre d'ajout des contrôles, si ces derniers sont ajoutés dynamiquement à la page.

Langage du périphérique Description du comportement

HTML

Langage du périphérique	Description du comportement
HTML	Si une propriété Title est définie pour un formulaire, le titre est écrit dans une balise <title>, dans la section <head> du document. Si des modèles sont rendus, ils sont écrits dans l'ordre, dans la balise <body>. Le code suivant illustre la structure de base d'une page HTML. `<head> <title>title</title> </head> <body> Add header template here. Add form contents here. Add footer template contents here. </body>` Vous pouvez utiliser le code précédent pour un formulaire qui tient sur une seule page, ou pour un formulaire non paginé.
WML	Si une propriété Title est définie pour un formulaire, le titre est écrit sous la forme de l'attribut Title d'une balise <card> du formulaire. (En de rares exceptions, des résultats inattendus peuvent se produire sur certains périphériques ; par ailleurs, le titre n'est pas écrit dans une balise <card>.) Si des modèles sont rendus, ils sont écrits dans l'ordre, dans une balise <p>, à l'intérieur d'une carte WML. Le code suivant illustre la structure de base d'une page WML. `<card title="title"> <p> header templatecontent template or form contentsfooter template </p> </card>`

Si une propriété Title est définie pour un formulaire, le titre est écrit dans une balise <title>, dans la section <head> du document.

Si des modèles sont rendus, ils sont écrits dans l'ordre, dans la balise <body>.

Le code suivant illustre la structure de base d'une page HTML.

<head>
  <title>title</title>
</head>
<body>
Add header template here.
  Add form contents here.
Add footer template contents here.
</body>

Vous pouvez utiliser le code précédent pour un formulaire qui tient sur une seule page, ou pour un formulaire non paginé.

WML

Si une propriété Title est définie pour un formulaire, le titre est écrit sous la forme de l'attribut Title d'une balise <card> du formulaire. (En de rares exceptions, des résultats inattendus peuvent se produire sur certains périphériques ; par ailleurs, le titre n'est pas écrit dans une balise <card>.)

Si des modèles sont rendus, ils sont écrits dans l'ordre, dans une balise <p>, à l'intérieur d'une carte WML.

Le code suivant illustre la structure de base d'une page WML.

<card title="title">
<p>
header templatecontent template or form contentsfooter template
</p>
</card>

Exemple

L'exemple suivant crée un formulaire avec deux étiquettes.

<%@ Page Inherits="System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile"
    Namespace="System.Web.UI.MobileControls"
    Assembly="System.Web.Mobile" %>

<mobile:Form runat="server">
  <mobile:Label runat="server">Aardvark</mobile:Label>
  <mobile:Label runat="server">Bear</mobile:Label>
</mobile:Form>

Voir aussi

Form, classe | Form, membres de classe | Guide de référence des contrôles

Partager via