Page.ClientTarget Propriété

Définition

Obtient ou définit une valeur qui vous permet de substituer la détection automatique des fonctionnalités d'un navigateur et de spécifier le mode de restitution d'une page pour des navigateurs clients particuliers.

public:
 property System::String ^ ClientTarget { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Browsable(false)]
public string ClientTarget { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.ClientTarget : string with get, set
Public Property ClientTarget As String

Valeur de propriété

String qui spécifie les fonctionnalités de navigateur que vous souhaitez substituer.

Attributs

Exemples

L’exemple de code suivant définit un ie302 alias et inclut les sections nécessaires pour configurer votre application dans son fichier Web.config. À l’aide de cet alias, vous pouvez définir la ClientTarget propriété ie302 sur et personnaliser des pages spécifiquement pour les navigateurs Internet Explorer 3.02.

<configuration>  
  <system.web>  
   <clientTarget>  
    <add alias="ie302" useragent="Mozilla/2.0 (compatible; MSIE 3.02; Windows NT 3.5)" />  
   </clientTarget>  
  </system.web>  
</configuration>  

Remarques

Si vous ne définissez pas la ClientTarget propriété, l’objet HttpBrowserCapabilities associé à la Page.Request propriété reflète les fonctionnalités du navigateur client. Si vous définissez cette propriété, la détection du navigateur client est désactivée et la page utilise les fonctionnalités de navigateur associées à la valeur (alias) que vous fournissez.

Le fichier de configuration racine Web.config sur l’ordinateur serveur web définit les alias par défaut suivants que vous pouvez utiliser comme abréviation pour les chaînes d’agent utilisateur courantes :

  • uplevel, qui spécifie des fonctionnalités de navigateur équivalentes à Internet Explorer 6.0.

  • downlevel, qui spécifie des fonctionnalités de navigateur équivalentes aux navigateurs plus anciens qui ne prennent pas en charge le script client. Vous pouvez utiliser cet alias pour déterminer le fonctionnement des pages web dans un navigateur pour lequel le script client est désactivé.

Vous pouvez définir l’alias par programmation à l’aide de cette propriété, ou vous pouvez le définir de manière déclarative à l’aide de l’attribut ClientTarget de la directive @ Page .

Vous pouvez définir des alias supplémentaires dans la clientTarget section du fichier Web.config au niveau de l’application. Pour plus d’informations, consultez élément clientTarget (schéma des paramètres ASP.NET).

S’applique à

Voir aussi