MobilePage, contrôle

Article
04/11/2008

Il s'agit de la classe de base de toutes les pages ASP.NET pour périphériques mobiles. Par conséquent, le contrôle MobilePage fournit la couche la plus éloignée de tous les conteneurs dans une application Web mobile ASP.NET. Il s'agit du seul conteneur associé à une URL ; il contient principalement les informations de style et de contexte communes à tous les contrôles.

Comme indiqué dans la syntaxe, une page mobile requiert deux directives. La première directive indique à l'infrastructure de page ASP.NET d'utiliser MobilePage en tant que classe de base de la page. L'attribut Inherits est requis. Si la page hérite directement d'un objet MobilePage, l'attribut Inherits doit prendre la valeur de l'espace de noms System.Web.UI.MobileControls.MobilePage. Si la page hérite d'une classe code-behind, le nom de cette classe doit être spécifié à la place. L'attribut Language est facultatif ; vous pouvez lui affecter la langue utilisée sur la page ou n'importe quelle autre page Web Forms.

La seconde directive inscrit l'espace de noms utilisé par les contrôles mobiles ASP.NET dotés du préfixe mobile. Vous pouvez ainsi déclarer les contrôles mobiles sur la page en utilisant le préfixe mobile.

<mobile:List...></mobile:list>

Bien que vous puissiez utiliser le préfixe de votre choix, le préfixe mobile est fortement recommandé pour assurer une compatibilité descendante.

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.

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

Règles relatives à la relation contenant-contenu

Le contrôle MobilePage est le contrôle de base d'une application Web mobile ASP.NET ; il n'est pas contenu dans d'autres contrôles. Un objet MobilePage peut contenir les contrôles ci-dessous.

Contrôle	Commentaires
System.Web.UI.MobileControls.Form	Un objet MobilePage doit contenir au moins un contrôle Form ; par ailleurs, il peut contenir plusieurs contrôles Form.
System.Web.UI.MobileControls.Stylesheet	Une feuille de style n'est pas requise pour un objet MobilePage. Un contrôle MobilePage ne contient qu'un seul contrôle StyleSheet, voire aucun.

Modèles de périphériques

Aucun.

Comportement spécifique au périphérique

Le rendu du contenu dans une page diffère selon les périphériques.

Exemple

L'exemple suivant crée une page mobile ainsi qu'un formulaire, puis ajoute une étiquette au formulaire.

<%@ 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">
   My First MobilePage, Form, and Label
  </mobile:Label>
</mobile:Form>

Voir aussi

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

Partager via