Fonctionnalités des contrôles serveur Web ASP.NET et du navigateur

Par défaut, ASP.NET détermine les fonctionnalités du navigateur en lisant les informations d'agent utilisateur transmises du navigateur au serveur pendant une demande. Il compare la chaîne d'agent utilisateur reçue du navigateur aux chaînes d'agent utilisateur stockées dans les fichiers de définition de navigateur. Ces fichiers de définition de navigateur contiennent des informations sur les fonctionnalités des différents agents utilisateurs. Quand ASP.NET recherche une correspondance entre la chaîne d'agent utilisateur actuelle et une chaîne d'agent utilisateur dans un fichier de définition de navigateur, il charge les fonctionnalités de navigateur correspondantes dans l'objet HttpBrowserCapabilities. Puis les propriétés de l'objet HttpBrowserCapabilities peuvent alors être utilisées pour déterminer si le type de navigateur représenté par l'agent utilisateur prend en charge les scripts, les styles, les frames, etc. Selon ces fonctionnalités, les contrôles de la page effectuent le rendu des contrôles Web à l'aide du balisage approprié.

Remarque
Les fonctionnalités de navigateur indiquent si le type de navigateur prend en général en charge des fonctionnalités telles que JavaScript, et non si ces fonctionnalités sont activées ou désactivées dans une instance individuelle du navigateur.

L'objet HttpBrowserCapabilities est disponible dans la propriété Browser de l'objet HttpRequest. Vous pouvez accéder à des informations sur certaines des fonctionnalités de navigateur dans les propriétés fortement typées de l'objet HttpBrowserCapabilities. D'autres fonctionnalités sont uniquement définies dans les fichiers de définition de navigateur et uniquement disponibles en tant qu'entrées dans une collection de dictionnaires.

Par exemple, pour déterminer si le type et la version du navigateur actuel prend en charge une version particulière de JavaScript, vous pouvez utiliser une propriété définie uniquement dans les fichiers de définition de navigateur (et non dans l'objet HttpBrowserCapabilitiesBase), comme indiqué dans l'exemple suivant :

string jsVersion = Request.Browser["JavaScriptVersion"];

Si le navigateur qui effectue la demande est Internet Explorer 8, la chaîne jsVersion contient la valeur « 1.5 ».

Pour déterminer si la demande provenait d'un appareil mobile, vous pouvez utiliser la propriété IsMobileDevice, comme indiqué dans l'exemple suivant :

bool isMobile = Request.Browser.IsMobileDevice;

ASP.NET stocke les fichiers de définition de navigateur par défaut dans le dossier suivant :

%SystemRoot%\Microsoft.NET\Framework\versionNumber\Config\Browsers

Remarque
Les fichiers de définition de navigateur ont été mis à jour pour ASP.NET 4, et les nouvelles versions n'offrent pas de compatibilité descendante avec les fichiers de définition de navigateur fournis avec les versions antérieures d'ASP.NET. Pour plus d'informations, consultez Comment : mettre à niveau une application Web ASP.NET vers ASP.NET 4.

Vous pouvez définir des types de navigateurs personnalisés en créant des fichiers de définition de navigateur et en les ajoutant au dossier Browsers d'ASP.NET ou au dossier App_Browsers d'un site Web. Si vous mettez à jour ou ajoutez des fichiers de définition de navigateur au dossier Browsers d'ASP.NET, vous devez exécuter l'outil aspnet_regbrowsers.exe.

Remarque

La section browserCaps des fichiers de configuration (.config) est déconseillée. À des fins de compatibilité descendante avec ASP.NET 1.1, les paramètres de configuration de la section browserCaps sont encore efficaces s'ils sont définis au niveau de l'application. Toutefois, les paramètres sont fusionnés avec les informations des fichiers de définition de navigateur au niveau de l'ordinateur et de tous les dossiers App_Browser au niveau de l'application. Pour plus d'informations, consultez Schéma du fichier de définition de navigateur (élément browsers).

Si vous préférez contrôler explicitement le rendu de la page plutôt que d'utiliser la détection automatique du navigateur, vous pouvez définir la propriété ClientTarget de la page. Vous pouvez définir la propriété de façon déclarative en tant qu'attribut de la directive @ Page de cette page, ou vous pouvez la définir par programmation.

La valeur de la propriété ClientTarget est un alias du type de navigateur pour lequel vous souhaitez effectuer le rendu de la page. Par exemple, si vous souhaitez afficher un aperçu du rendu d'une page sur un iPhone Apple sans utiliser d'émulateur, vous pouvez créer un alias pour l'iPhone et affecter à la propriété ClientTarget la valeur de cet alias. L'alias que vous spécifiez doit être défini dans la section clientTarget du fichier de configuration. Les valeurs prédéfinies par défaut sont uplevel et downlevel.

Vous pouvez créer des alias supplémentaires en les définissant dans le fichier Web.config racine ou dans le fichier Web.config de l'application. Pour plus d'informations, consultez clientTarget, élément (Schéma des paramètres ASP.NET).

Les fonctionnalités AJAX dans ASP.NET sont compatibles avec la plupart des navigateurs modernes et fonctionnent avec les paramètres de sécurité par défaut de ces navigateurs. Ces contrôles et fonctionnalités requièrent que le navigateur soit capable d'exécuter le script client. Les contrôles UpdatePanel et ScriptManager sont des exemples de contrôles compatibles AJAX. Pour obtenir la liste des navigateurs compatibles et des paramètres de sécurité recommandés pour les contrôles et les fonctionnalités compatibles AJAX, consultez Paramètres de sécurité de navigateur pour les pages ASP.NET Ajax.

Remarque
Vous pouvez utiliser les propriétés exposées par l'objet HttpBrowserCapabilities pour déterminer si un type de navigateur prend en charge ECMAScript (JScript, JavaScript). Toutefois, l'objet HttpBrowserCapabilities n'indique pas si JavaScript est activé pour une instance particulière d'un type de navigateur.

Pour obtenir une vue d'ensemble des fonctionnalités AJAX dans ASP.NET, consultez Microsoft Ajax.

Certaines fonctionnalités des contrôles serveur ASP.NET dépendent de la capacité à exécuter les scripts clients. Le script client est généré automatiquement et envoyé en tant qu'élément de la page, si le navigateur est capable d'exécuter les scripts. Même dans ce cas, il se peut que certains utilisateurs aient désactivé l'exécution de scripts dans leur navigateur. Ils ne pourront donc pas bénéficier totalement des fonctionnalités des contrôles. Pour plus d'informations, consultez Script client dans les pages Web ASP.NET.

Tâches

Référence

Autres ressources