ClientTarget Classe
Définition
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.
Définit l’alias associé à l’agent utilisateur cible pour lequel ASP.NET contrôles serveur doivent afficher le contenu. Cette classe ne peut pas être héritée.
public ref class ClientTarget sealed : System::Configuration::ConfigurationElementpublic sealed class ClientTarget : System.Configuration.ConfigurationElementtype ClientTarget = class
inherit ConfigurationElementPublic NotInheritable Class ClientTarget
Inherits ConfigurationElement- Héritage
Exemples
Cette section fournit deux exemples de code. La première montre comment spécifier de manière déclarative des valeurs pour plusieurs propriétés de la ClientTarget classe. La deuxième montre comment obtenir l’objet ClientTargetCollection à partir du fichier de configuration. Vous utilisez cet objet pour accéder aux ClientTarget objets qu’il contient.
L’exemple de code suivant montre comment spécifier de manière déclarative des valeurs pour plusieurs propriétés de la ClientTarget classe.
<clientTarget>
<add alias=
"uplevel"
userAgent="Mozilla/5.0 (compatible;MSIE 6.0;Windows NT 5.1)"/>
<add alias="downlevel" userAgent="Generic Downlevel"/>
</clientTarget>
L’exemple de code suivant montre comment obtenir l’objet ClientTargetCollection à partir du fichier de configuration.
// Get the Web application configuration.
System.Configuration.Configuration configuration =
WebConfigurationManager.OpenWebConfiguration(
"/aspnetTest");
// Get the <clientTarget> section.
ClientTargetSection clientTargetSection =
(ClientTargetSection)configuration.GetSection(
"system.web/clientTarget");
// Get the client target collection.
ClientTargetCollection clientTargets =
clientTargetSection.ClientTargets;
' Get the Web application configuration.
Dim configuration _
As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")
' Get the <clientTarget> section.
Dim clientTargetSection _
As ClientTargetSection = _
CType(configuration.GetSection( _
"system.web/clientTarget"), _
ClientTargetSection)
' Get the client target collection.
Dim clientTargets _
As ClientTargetCollection = _
clientTargetSection.ClientTargets
Remarques
La ClientTarget classe fait référence aux éléments ajoutés dans la clientTarget section du fichier de configuration.
La ClientTarget classe appartient à un groupe qui inclut la ClientTargetCollection classe et la ClientTargetSection classe.
La ClientTarget classe contient deux propriétés identifiant un navigateur client, également nommée agent utilisateur. Une propriété est l’alias associé au navigateur client identifié par la deuxième propriété. ASP.NET utilise ces informations pour afficher les contrôles serveur dans une page.
Pour plus d’informations sur la façon dont l’agent utilisateur ou son alias est utilisé par programmation, consultez la Page.ClientTarget propriété. Pour plus d’informations sur l’utilisation déclarative de l’agent utilisateur ou de son alias, consultez @ Page.
Si la Page.ClientTarget propriété n’est pas définie, l’objet HttpBrowserCapabilities associé à la Page.Request propriété reflète les fonctionnalités du navigateur client. (Elle reflète les fonctionnalités du type de navigateur, mais pas nécessairement les paramètres d’une instance spécifique de ce navigateur.) Si la propriété est définie, la détection du navigateur client est désactivée et la page utilise des fonctionnalités de navigateur associées à la chaîne de l’agent utilisateur que vous définissez. Vous pouvez définir cette propriété sur n’importe quelle chaîne d’agent utilisateur valide.
Constructeurs
| Nom | Description |
|---|---|
| ClientTarget(String, String) |
Initialise une nouvelle instance de la classe ClientTarget. |
Propriétés
| Nom | Description |
|---|---|
| Alias |
Obtient l’alias de l’agent utilisateur. |
| CurrentConfiguration |
Obtient une référence à l’instance de niveau Configuration supérieur qui représente la hiérarchie de configuration à laquelle appartient l’instance actuelle ConfigurationElement . (Hérité de ConfigurationElement) |
| ElementInformation |
Obtient un ElementInformation objet qui contient les informations et fonctionnalités non personnalisables de l’objet ConfigurationElement . (Hérité de ConfigurationElement) |
| ElementProperty |
Obtient l’objet ConfigurationElementProperty qui représente l’objet ConfigurationElement lui-même. (Hérité de ConfigurationElement) |
| EvaluationContext |
Obtient l'objet ContextInformation pour l'objet ConfigurationElement. (Hérité de ConfigurationElement) |
| HasContext |
Obtient une valeur qui indique si la CurrentConfiguration propriété est |
| Item[ConfigurationProperty] |
Obtient ou définit une propriété ou un attribut de cet élément de configuration. (Hérité de ConfigurationElement) |
| Item[String] |
Obtient ou définit une propriété, un attribut ou un élément enfant de cet élément de configuration. (Hérité de ConfigurationElement) |
| LockAllAttributesExcept |
Obtient la collection d’attributs verrouillés. (Hérité de ConfigurationElement) |
| LockAllElementsExcept |
Obtient la collection d’éléments verrouillés. (Hérité de ConfigurationElement) |
| LockAttributes |
Obtient la collection d’attributs verrouillés. (Hérité de ConfigurationElement) |
| LockElements |
Obtient la collection d’éléments verrouillés. (Hérité de ConfigurationElement) |
| LockItem |
Obtient ou définit une valeur indiquant si l’élément est verrouillé. (Hérité de ConfigurationElement) |
| Properties |
Obtient la collection de propriétés. (Hérité de ConfigurationElement) |
| UserAgent |
Obtient le nom d’identification de l’agent utilisateur. |
Méthodes
| Nom | Description |
|---|---|
| DeserializeElement(XmlReader, Boolean) |
Lit le code XML à partir du fichier de configuration. (Hérité de ConfigurationElement) |
| Equals(Object) |
Compare l’instance actuelle ConfigurationElement à l’objet spécifié. (Hérité de ConfigurationElement) |
| GetHashCode() |
Obtient une valeur unique représentant l’instance actuelle ConfigurationElement . (Hérité de ConfigurationElement) |
| GetTransformedAssemblyString(String) |
Retourne la version transformée du nom d’assembly spécifié. (Hérité de ConfigurationElement) |
| GetTransformedTypeString(String) |
Retourne la version transformée du nom de type spécifié. (Hérité de ConfigurationElement) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| Init() |
Définit l’objet ConfigurationElement à son état initial. (Hérité de ConfigurationElement) |
| InitializeDefault() |
Permet d’initialiser un jeu de valeurs par défaut pour l’objet ConfigurationElement . (Hérité de ConfigurationElement) |
| IsModified() |
Indique si cet élément de configuration a été modifié depuis son dernier enregistrement ou chargement, lorsqu’il est implémenté dans une classe dérivée. (Hérité de ConfigurationElement) |
| IsReadOnly() |
Obtient une valeur indiquant si l’objet ConfigurationElement est en lecture seule. (Hérité de ConfigurationElement) |
| ListErrors(IList) |
Ajoute les erreurs de propriété non valides dans cet ConfigurationElement objet et, dans tous les sous-éléments, à la liste passée. (Hérité de ConfigurationElement) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Obtient une valeur indiquant si un attribut inconnu est rencontré lors de la désérialisation. (Hérité de ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Obtient une valeur indiquant si un élément inconnu est rencontré lors de la désérialisation. (Hérité de ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Lève une exception lorsqu’une propriété requise est introuvable. (Hérité de ConfigurationElement) |
| PostDeserialize() |
Appelé après la désérialisation. (Hérité de ConfigurationElement) |
| PreSerialize(XmlWriter) |
Appelé avant la sérialisation. (Hérité de ConfigurationElement) |
| Reset(ConfigurationElement) |
Réinitialise l’état interne de l’objet ConfigurationElement , y compris les verrous et les collections de propriétés. (Hérité de ConfigurationElement) |
| ResetModified() |
Réinitialise la valeur de la IsModified() méthode |
| SerializeElement(XmlWriter, Boolean) |
Écrit le contenu de cet élément de configuration dans le fichier de configuration en cas d’implémentation dans une classe dérivée. (Hérité de ConfigurationElement) |
| SerializeToXmlElement(XmlWriter, String) |
Écrit les balises externes de cet élément de configuration dans le fichier de configuration en cas d’implémentation dans une classe dérivée. (Hérité de ConfigurationElement) |
| SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Définit une propriété sur la valeur spécifiée. (Hérité de ConfigurationElement) |
| SetReadOnly() |
Définit la IsReadOnly() propriété de l’objet ConfigurationElement et de tous les sous-éléments. (Hérité de ConfigurationElement) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modifie l’objet ConfigurationElement pour supprimer toutes les valeurs qui ne doivent pas être enregistrées. (Hérité de ConfigurationElement) |
