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 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 à

Partager via