Partager via

Méthodes d'évaluation de périphérique

  • Article

En matière de contrôles mobiles ASP.NET, les méthodes d'évaluation de périphérique vous permettent de créer des filtres nommés utilisables directement dans la méthode HasCapability. Vous pouvez également utiliser ces filtres de manière indirecte dans le fichier Web.config, à l'aide de l'élément <Choice> de la section <DeviceSpecific>.

Pour spécifier un filtre nommé, ajoutez une entrée à la section <deviceFilters> du fichier Web.config. L'exemple suivant montre comment définir un filtre de périphérique nommé isHTML32.

<filter name="isHTML32" compare="PreferredRenderingType"
  argument="html32" />

Au moment de l'exécution, ce filtre compare la valeur de la propriété PreferredRenderingType de l'instance MobileCapabilities de la demande active à la valeur html32.

L'exemple suivant montre comment définir une nouvelle fonctionnalité nommée GPSEnabled. Pour plus d'informations, consultez Spécification des noms de types qualifiés complets.

namespace MyNamespace
{
    public class MyCapabilityEvaluators
    {
        public static bool IsGPSEnabled(
            System.Web.Mobile.MobileCapabilities capabilities,
             String unusedArg)
        {
            // processing code
        }
    }
}

Ajoutez l'élément ci-dessous dans le fichier Web.config approprié pour ajouter la nouvelle fonctionnalité :

<deviceFilters>
  <filter name="GPSEnabled" 
    type="MyNamespace.MyCapabilityEvaluators, MyAssembly"
      method="IsGPSEnabled" />
</deviceFilters>

Lors du rendu, l'un des choix compris dans un élément <DeviceSpecific> est sélectionné d'après les fonctionnalités du périphérique cible. La comparaison porte d'abord sur le nom du filtre par rapport aux filtres définis sur la page. S'il existe une méthode ayant la signature adéquate dans le fichier Web.config ou la hiérarchie de configuration, elle est utilisée pour évaluer l'entrée <Choice> d'un filtre possédant le nom approprié.

Voir aussi

Référence

Tableau des fonctionnalités de périphérique
<filter>, élément

Concepts

Recommandations sur le filtrage de périphérique
Rendu spécifique au périphérique
Évaluation des fonctionnalités par programme