MobileCapabilities, classe

Article
08/21/2007

Fournit une source unique permettant d'accéder aux informations sur les fonctionnalités relatives à un périphérique client et d'effectuer des requêtes par rapport à ces fonctionnalités.

Espace de noms : System.Web.Mobile
Assembly : System.Web.Mobile (dans system.web.mobile.dll)

Syntaxe

'Déclaration
Public Class MobileCapabilities
    Inherits HttpBrowserCapabilities
'Utilisation
Dim instance As MobileCapabilities

public class MobileCapabilities : HttpBrowserCapabilities

public ref class MobileCapabilities : public HttpBrowserCapabilities

public class MobileCapabilities extends HttpBrowserCapabilities

public class MobileCapabilities extends HttpBrowserCapabilities

Notes

La classe MobileCapabilities étend la classe HttpBrowserCapabilities. La classe MobileCapabilities expose un grand nombre de propriétés en lecture seule qui fournissent un accès de type sécurisé au dictionnaire des fonctionnalités de l'objet Browser, comme décrit dans Extended Browser Capabilities.

Vous pouvez utiliser la propriété Browser de l'objet HttpRequest pour pointer vers une instance d'un objet MobileCapabilities, qui peut alors être utilisée pour lire les fonctionnalités du navigateur et du périphérique à l'origine de la demande.

Rubrique	Emplacement
Procédure pas à pas : ajout de prise en charge des périphériques	Référence pour les applications mobiles

Exemple

Pendant le chargement de la page, l'objet MobileCapabilities obtient les fonctionnalités par l'intermédiaire de la propriété Browser comme cela a été abordé précédemment. Les propriétés PreferredRenderingMime et ScreenCharactersWidth de l'objet MobileCapabilities informent le navigateur en définissant les propriétés sur l'objet HttpResponse et également en définissant par programme la propriété Text de certains contrôles sur la page.

<%@ Page Inherits="System.Web.UI.MobileControls.MobilePage" 
    Language="c#" %>
<script language="c#" runat="server">
public void Page_Load(Object sender, EventArgs e)
{
    System.Web.Mobile.MobileCapabilities currentCapabilities;
    MobileCapabilities currentCapabilities = 
        (MobileCapabilities)Request.Browser;
    // Programatically find the mobile capabilities without using 
    // DeviceSpecific Filters.
    if(currentCapabilities.PreferredRenderingMIME=="text/html")
    {
        Label2.Text = "You are using an html supported device.";
    }
    else if(currentCapabilities.PreferredRenderingMIME == 
        "text/vnd.wap.wml")
    {
        Label2.Text = "You are using a wml supported device.";
    }
    Label1.Text = "Screen Width (chars): " + 
        currentCapabilities.ScreenCharactersWidth;
 }
 </script>
 <Mobile:Form runat="server" id=frmTemplate >
      <mobile:label ID="Label1" runat="server" />
      <mobile:label ID="Label2" runat="server" />
 </Mobile:Form>

Sécurité .NET Framework

AspNetHostingPermission pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
AspNetHostingPermission pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

Hiérarchie d'héritage

System.Object
   System.Web.Configuration.HttpCapabilitiesBase
     System.Web.HttpBrowserCapabilities
      System.Web.Mobile.MobileCapabilities

Sécurité des threads

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Plates-formes

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1

Voir aussi

Référence

Membres MobileCapabilities
System.Web.Mobile, espace de noms
MobileCapabilities, classe
Adding New Device Adapters and Device Support

Autres ressources

Fonctionnalités des périphériques mobiles
Understanding ASP.NET Adaptive Rendering
Fonctionnalité des ensembles d'adaptateurs

Partager via