Page.ClientTarget Propriété

Référence

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

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

Attributs: BrowsableAttribute

Exemples

L’exemple de code suivant définit un ie302 alias et inclut des 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é sur ie302 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 raccourci pour les chaînes d’agent utilisateur courantes :

uplevel, qui spécifie les fonctionnalités de navigateur équivalentes à Internet Explorer 6.0.
downlevel, qui spécifie les 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 qui a désactivé le script client.

Vous pouvez définir l’alias par programmation à l’aide de cette propriété ou 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’élément clientTarget (schéma ASP.NET Paramètres).

S’applique à