Fonctionnalités du navigateur étendues
Mise à jour : novembre 2007
La classe MobileCapabilities repose sur les fonctionnalités du navigateur standard de ASP.NET. Lorsqu'un client se connecte à une page Web mobile ASP.NET, ASP.NET détermine le périphérique à l'origine de la demande à partir des informations contenues dans cette demande, puis attache un objet MobileCapabilities à la demande. L'application peut accéder à cet objet via la propriété Browser de l'objet HttpRequest, qui est mappée à la propriété Request de l'objet Page.
Le code d'application peut accéder aux fonctionnalités individuelles d'un objet MobileCapabilities de deux façons. La première façon consiste pour le code d'application à accéder à toutes les propriétés de fonctionnalité de haut niveau. Chacune de ces propriétés en lecture seule retourne la valeur de type sécurisé de la fonctionnalité correspondante ou une valeur par défaut appropriée. L'exemple suivant montre comment utiliser une propriété de haut niveau.
if (((MobileCapabilities)Request.Browser).ScreenCharactersWidth > 20)
{
// Coding for big screen capabilities is placed here.
}
else
{
// Coding for small screen capabilities is placed here.
}
La seconde façon consiste pour le code d'application à accéder aux fonctionnalités en tant que dictionnaire, via l'indexeur par défaut. Les valeurs du dictionnaire sont les mêmes que celles entrées dans la section <browserCaps> du fichier Machine.config ou Web.config. La valeur retournée est toujours une string ou une référence null si la valeur n'est pas définie. L'application doit analyser cette chaîne si nécessaire. L'exemple suivant illustre l'utilisation de la même fonctionnalité que dans l'exemple précédent, mais à l'aide d'une propriété de dictionnaire.
String screenWidthText = Request.Browser["screenCharactersWidth"];
int screenWidth = 40;
if (screenWidthText != null)
screenWidth = Int32.Parse(screenWidthText);
if (screenWidth > 20)
{
// This block contains code supporting a larger screen size.
}
else
{
// This block contains code supporting a smaller screen size.
}
.gif "Remarque") Remarque : |
|---|
Les propriétés MobileCapabilities dérivées des entrées de dictionnaire, au lieu d'être définies directement dans le fichier Web.config, peuvent provoquer une incompatibilité sur certains périphériques. |