clientTarget, élément (Schéma des paramètres ASP.NET)

Mise à jour : novembre 2007

Ajoute les alias d'agents utilisateur spécifiques à une collection interne d'alias d'agents utilisateur.

<configuration>, élément
  system.web, élément (Schéma des paramètres ASP.NET)
    clientTarget, élément (Schéma des paramètres ASP.NET)

<clientTarget> 
   <add... />
   <remove... />
   <clear/>
</clientTarget>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Aucun.

Éléments enfants

Élément

Description

add

Élément facultatif.

Ajoute l'alias d'un agent utilisateur spécifique à une collection interne d'alias d'agents utilisateur.

clear

Élément facultatif.

Supprime tous les alias actuellement contenus ou hérités du fichier Web.config spécifié.

remove

Élément facultatif.

Supprime l'alias d'un agent utilisateur spécifique d'une collection interne d'alias d'agents utilisateur. La valeur doit correspondre exactement à celle d'une directive add précédente. Les sélections par caractères génériques ne sont pas prises en charge.

Éléments parents

Élément

Description

configuration

Spécifie l'élément racine requis dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

system.web

Spécifie l'élément racine de la section de configuration ASP.NET.

Notes

La collection d'alias d'agents utilisateur indique les agents utilisateur cibles dont les contrôles serveur ASP.NET doivent rendre le contenu.

Configuration par défaut

L'élément clientTarget par défaut suivant est configuré dans le fichier Web.config racine dans le .NET Framework version 2.0.

<clientTarget>
     <add alias="ie5" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 4.0" />
     <add alias="ie4" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0" />
     <add alias="uplevel" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 5.1)" />
     <add alias="downlevel" userAgent="Generic Downlevel" />
</clientTarget>

L'élément clientTarget par défaut est configuré dans le fichier Machine.config des versions 1.0 et 1.1 du .NET Framework.

<clientTarget>
     <add alias="ie5" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 4.0)"/>
     <add alias="ie4" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0)"/>
     <add alias="uplevel" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0)"/>
     <add alias="downlevel" userAgent="Unknown"/>
</clientTarget>

Exemple

L'exemple de code suivant montre comment ajouter quatre alias d'agent utilisateur.

<configuration>
   <system.web>
      <clientTarget>
         <add alias="ie5" userAgent="Mozilla/4.0 (compatible;MSIE 5.5;Windows NT 4.0)"/>
         <add alias="ie4" userAgent="Mozilla/4.0 (compatible;MSIE 4.0;Windows NT 4.0)"/>
         <add alias="uplevel" userAgent="Mozilla/4.0 (compatible;MSIE 4.0;Windows NT 4.0)"/>
         <add alias="downlevel" userAgent="Unknown"/>
      </clientTarget>
   </system.web>
</configuration>

Informations sur les éléments

Gestionnaire de section de configuration

System.Web.Configuration.ClientTargetSection

Membre de configuration

System.Web.Configuration.ClientTarget

SystemWebSectionGroup.ClientTarget

Page.ClientTarget

Emplacements configurables

Machine.config

Web.config racine

Web.config au niveau de l'application

Web.config de niveau répertoire virtuel ou physique

Configuration requise

Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0

.NET Framework version 1.0, 1.1 ou 2.0

Microsoft Visual Studio 2003 ou Visual Studio 2005

Voir aussi

Tâches

Comment : verrouiller des paramètres de configuration ASP.NET

Concepts

Vue d'ensemble de la configuration ASP.NET

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

Sécurisation de la configuration ASP.NET

Scénarios de configuration ASP.NET

Référence

system.web, élément (Schéma des paramètres ASP.NET)

configuration, élément (Schéma des paramètres généraux)

add, élément de clientTarget (Schéma des paramètres ASP.NET)

clear, élément de clientTarget (Schéma des paramètres ASP.NET)

remove, élément de clientTarget (Schéma des paramètres ASP.NET)

@ Page

System.Configuration

System.Web.Configuration

Autres ressources

Fichiers de configuration ASP.NET

Paramètres de configuration ASP.NET

Paramètres généraux de configuration (ASP.NET)

API de configuration ASP.NET