ClientTarget Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Define el alias asociado al agente de usuario de destino para el que ASP.NET controles de servidor deben representar el contenido. Esta clase no puede heredarse.
public ref class ClientTarget sealed : System::Configuration::ConfigurationElementpublic sealed class ClientTarget : System.Configuration.ConfigurationElementtype ClientTarget = class
inherit ConfigurationElementPublic NotInheritable Class ClientTarget
Inherits ConfigurationElement- Herencia
Ejemplos
En esta sección se proporcionan dos ejemplos de código. En la primera se muestra cómo especificar de forma declarativa valores para varias propiedades de la ClientTarget clase . En el segundo se muestra cómo obtener el ClientTargetCollection objeto del archivo de configuración. Este objeto se usa para tener acceso a los ClientTarget objetos que contiene.
En el ejemplo de código siguiente se muestra cómo especificar de forma declarativa valores para varias propiedades de la ClientTarget clase .
<clientTarget>
<add alias=
"uplevel"
userAgent="Mozilla/5.0 (compatible;MSIE 6.0;Windows NT 5.1)"/>
<add alias="downlevel" userAgent="Generic Downlevel"/>
</clientTarget>
En el ejemplo de código siguiente se muestra cómo obtener el ClientTargetCollection objeto del archivo de configuración.
// 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
Comentarios
La ClientTarget clase hace referencia a elementos que se agregan en la clientTarget sección del archivo de configuración.
La ClientTarget clase pertenece a un grupo que incluye la ClientTargetCollection clase y la ClientTargetSection clase .
La ClientTarget clase contiene dos propiedades que identifican un explorador cliente, también denominado agente de usuario. Una propiedad es el alias asociado al explorador cliente identificado por la segunda propiedad. ASP.NET usa esta información para representar controles de servidor en una página.
Para obtener información sobre cómo se usa el agente de usuario o su alias mediante programación, consulte la Page.ClientTarget propiedad . Para obtener información sobre cómo se usa declarativamente el agente de usuario o su alias, vea @ Page.
Si no se establece la Page.ClientTarget propiedad, el HttpBrowserCapabilities objeto asociado a la Page.Request propiedad refleja las funcionalidades del explorador cliente. (Refleja las funcionalidades del tipo de explorador, pero no necesariamente la configuración en una instancia específica de ese explorador). Si se establece la propiedad , la detección del explorador cliente está deshabilitada y la página usa funcionalidades de explorador asociadas a la cadena del agente de usuario que defina. Puede establecer esta propiedad en cualquier cadena de agente de usuario válida.
Constructores
| Nombre | Description |
|---|---|
| ClientTarget(String, String) |
Inicializa una nueva instancia de la clase ClientTarget. |
Propiedades
| Nombre | Description |
|---|---|
| Alias |
Obtiene el alias del agente de usuario. |
| CurrentConfiguration |
Obtiene una referencia a la instancia de nivel Configuration superior que representa la jerarquía de configuración a la que pertenece la instancia actual ConfigurationElement . (Heredado de ConfigurationElement) |
| ElementInformation |
Obtiene un ElementInformation objeto que contiene la información y la funcionalidad no personalizables del ConfigurationElement objeto . (Heredado de ConfigurationElement) |
| ElementProperty |
Obtiene el ConfigurationElementProperty objeto que representa el ConfigurationElement propio objeto. (Heredado de ConfigurationElement) |
| EvaluationContext |
Obtiene el objeto ContextInformation para el objeto ConfigurationElement. (Heredado de ConfigurationElement) |
| HasContext |
Obtiene un valor que indica si la CurrentConfiguration propiedad es |
| Item[ConfigurationProperty] |
Obtiene o establece una propiedad o atributo de este elemento de configuración. (Heredado de ConfigurationElement) |
| Item[String] |
Obtiene o establece una propiedad, un atributo o un elemento secundario de este elemento de configuración. (Heredado de ConfigurationElement) |
| LockAllAttributesExcept |
Obtiene la colección de atributos bloqueados. (Heredado de ConfigurationElement) |
| LockAllElementsExcept |
Obtiene la colección de elementos bloqueados. (Heredado de ConfigurationElement) |
| LockAttributes |
Obtiene la colección de atributos bloqueados. (Heredado de ConfigurationElement) |
| LockElements |
Obtiene la colección de elementos bloqueados. (Heredado de ConfigurationElement) |
| LockItem |
Obtiene o establece un valor que indica si el elemento está bloqueado. (Heredado de ConfigurationElement) |
| Properties |
Obtiene la colección de propiedades. (Heredado de ConfigurationElement) |
| UserAgent |
Obtiene el nombre de identificación del agente de usuario. |
Métodos
| Nombre | Description |
|---|---|
| DeserializeElement(XmlReader, Boolean) |
Lee XML del archivo de configuración. (Heredado de ConfigurationElement) |
| Equals(Object) |
Compara la instancia actual ConfigurationElement con el objeto especificado. (Heredado de ConfigurationElement) |
| GetHashCode() |
Obtiene un valor único que representa la instancia actual ConfigurationElement . (Heredado de ConfigurationElement) |
| GetTransformedAssemblyString(String) |
Devuelve la versión transformada del nombre de ensamblado especificado. (Heredado de ConfigurationElement) |
| GetTransformedTypeString(String) |
Devuelve la versión transformada del nombre de tipo especificado. (Heredado de ConfigurationElement) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| Init() |
Establece el ConfigurationElement objeto en su estado inicial. (Heredado de ConfigurationElement) |
| InitializeDefault() |
Se usa para inicializar un conjunto predeterminado de valores para el ConfigurationElement objeto . (Heredado de ConfigurationElement) |
| IsModified() |
Indica si este elemento de configuración se ha modificado desde que se guardó o cargó por última vez, cuando se implementó en una clase derivada. (Heredado de ConfigurationElement) |
| IsReadOnly() |
Obtiene un valor que indica si el ConfigurationElement objeto es de solo lectura. (Heredado de ConfigurationElement) |
| ListErrors(IList) |
Agrega los errores de propiedad no válida en este ConfigurationElement objeto y, en todos los subelementos, a la lista pasada. (Heredado de ConfigurationElement) |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Obtiene un valor que indica si se encuentra un atributo desconocido durante la deserialización. (Heredado de ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Obtiene un valor que indica si se encuentra un elemento desconocido durante la deserialización. (Heredado de ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Produce una excepción cuando no se encuentra una propiedad necesaria. (Heredado de ConfigurationElement) |
| PostDeserialize() |
Se llama después de la deserialización. (Heredado de ConfigurationElement) |
| PreSerialize(XmlWriter) |
Se llama antes de la serialización. (Heredado de ConfigurationElement) |
| Reset(ConfigurationElement) |
Restablece el estado interno del ConfigurationElement objeto, incluidos los bloqueos y las colecciones de propiedades. (Heredado de ConfigurationElement) |
| ResetModified() |
Restablece el valor del IsModified() método a |
| SerializeElement(XmlWriter, Boolean) |
Escribe el contenido de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada. (Heredado de ConfigurationElement) |
| SerializeToXmlElement(XmlWriter, String) |
Escribe las etiquetas externas de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada. (Heredado de ConfigurationElement) |
| SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Establece una propiedad en el valor especificado. (Heredado de ConfigurationElement) |
| SetReadOnly() |
Establece la IsReadOnly() propiedad para el ConfigurationElement objeto y todos los subelementos. (Heredado de ConfigurationElement) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modifica el ConfigurationElement objeto para quitar todos los valores que no se deben guardar. (Heredado de ConfigurationElement) |
