HttpListenerElement 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í.
Representa el elemento HttpListener del archivo de configuración. Esta clase no puede heredarse.
public ref class HttpListenerElement sealed : System::Configuration::ConfigurationElementpublic sealed class HttpListenerElement : System.Configuration.ConfigurationElementtype HttpListenerElement = class
inherit ConfigurationElementPublic NotInheritable Class HttpListenerElement
Inherits ConfigurationElement- Herencia
Comentarios
Esta clase corresponde al <elemento de configuración httpListener> Element (Network Settings). Esta clase proporciona acceso mediante programación a la información que se puede almacenar en archivos de configuración.
La UnescapeRequestUrl propiedad indica si HttpListener usa el URI sin escape sin procesar en lugar del URI convertido donde se convierten los valores codificados por porcentaje y se realizan otros pasos de normalización.
Cuando una instancia HttpListener recibe una solicitud a través del servicio http.sys, crea una instancia de la cadena de URI proporcionada por http.sysy la expone como la propiedad HttpListenerRequest.Url.
El servicio http.sys expone dos cadenas de URI de solicitud:
URI sin formato
URI convertido
El URI sin formato es el System.Uri proporcionado en la línea de solicitud de una solicitud HTTP:
GET /path/
Host: www.contoso.com
El URI sin formato proporcionado por http.sys para la solicitud mencionada anteriormente es "/path/". Representa la cadena que sigue al verbo HTTP tal como se envió a través de la red.
El servicio http.sys crea un URI convertido a partir de la información proporcionada en la solicitud mediante el URI proporcionado en la línea de solicitud HTTP y el encabezado host para determinar el servidor de origen al que se debe reenviar la solicitud. Para ello, se compara la información de la solicitud con un conjunto de prefijos de URI registrados. La documentación del SDK del servidor HTTP hace referencia a este URI convertido como la estructura de HTTP_COOKED_URL .
Para poder comparar la solicitud con prefijos de URI registrados, es necesario realizar una normalización de la solicitud. Para el ejemplo anterior, el URI convertido sería el siguiente:
http://www.contoso.com/path/
El servicio http.sys combina el valor de propiedad Uri.Host y la cadena de la línea de solicitud para crear un URI convertido. Además, http.sys y la System.Uri clase también hacen lo siguiente:
Anula el escape de todos los valores codificados por porcentajes.
Convierte caracteres no ASCII codificados por porcentaje en una representación de caracteres UTF-16. Tenga en cuenta que se admiten caracteres UTF-8 y ANSI/DBCS, así como caracteres Unicode (codificación Unicode con el formato %uXXXX).
Ejecuta otros pasos de normalización, como la compresión de ruta de acceso.
Dado que la solicitud no contiene ninguna información sobre la codificación usada para los valores codificados por porcentajes, es posible que no sea posible determinar la codificación correcta simplemente mediante el análisis de los valores codificados por porcentajes.
Por lo tanto, http.sys proporciona dos claves del Registro para modificar el proceso:
| Clave del Registro | Valor predeterminado | Descripción |
|---|---|---|
| EnableNonUTF8 | 1 | Si es cero, http.sys solo acepta direcciones URL codificadas con UTF-8.Si no es cero, http.sys también acepta direcciones URL codificadas en ANSI o con codificación DBCS en las solicitudes. |
| FavorUTF8 | 1 | Si no es cero, http.sys siempre intenta descodificar una dirección URL como UTF-8 en primer lugar; si se produce un error en esa conversión y EnableNonUTF8 es distinto de cero, Http.sys intenta descodificarla como ANSI o DBCS.Si cero (y EnableNonUTF8 no es cero), http.sys intenta descodificarlo como ANSI o DBCS; si no es correcto, intenta una conversión UTF-8. |
Cuando HttpListener recibe una solicitud, usa el URI convertido de http.sys como entrada a la propiedad Url.
Es necesario admitir caracteres además de caracteres y números en URI. Un ejemplo es el siguiente URI, que se usa para recuperar información del cliente para el número de cliente "1/3812":
http://www.contoso.com/Customer('1%2F3812')/
Anote la barra diagonal codificada por porcentaje en el URI (%2F). Esto es necesario, ya que, en este caso, el carácter de barra diagonal representa los datos y no un delimitador de ruta de acceso.
Si se pasa la cadena al constructor URI, se producirá el siguiente URI:
http://www.contoso.com/Customer('1/3812')/
Dividir la ruta de acceso en sus segmentos daría lugar a los siguientes elementos:
Customer('1
3812')
Esta no es la intención del remitente de la solicitud.
Si la UnescapeRequestUrl propiedad se establece en false, cuando HttpListener recibe una solicitud, usa el URI sin formato en lugar del URI convertido de http.sys como entrada a la Url propiedad .
Constructores
| HttpListenerElement() |
Inicializa una nueva instancia de la clase HttpListenerElement. |
Propiedades
| CurrentConfiguration |
Obtiene una referencia a la instancia de Configuration de nivel superior que representa la jerarquía de configuración a la que pertenece la instancia actual de ConfigurationElement. (Heredado de ConfigurationElement) |
| ElementInformation |
Obtiene un objeto ElementInformation que contiene la funcionalidad e información no personalizable del objeto ConfigurationElement. (Heredado de ConfigurationElement) |
| ElementProperty |
Obtiene el objeto ConfigurationElementProperty que representa al propio objeto ConfigurationElement. (Heredado de ConfigurationElement) |
| EvaluationContext |
Obtiene el objeto ContextInformation para el objeto ConfigurationElement. (Heredado de ConfigurationElement) |
| HasContext |
Obtiene un valor que indica si la propiedad CurrentConfiguration 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) |
| Timeouts |
Obtiene los elementos de tiempo de espera predeterminados utilizados para un objeto HttpListener . |
| UnescapeRequestUrl |
Obtiene un valor que indica si HttpListener usa el URI sin secuencias de escape y sin formato en lugar del URI convertido. |
Métodos
| DeserializeElement(XmlReader, Boolean) |
Lee XML del archivo de configuración. (Heredado de ConfigurationElement) |
| Equals(Object) |
Compara la instancia actual de ConfigurationElement con el objeto especificado. (Heredado de ConfigurationElement) |
| GetHashCode() |
Obtiene un valor único que representa la instancia actual de 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 objeto ConfigurationElement en su estado inicial. (Heredado de ConfigurationElement) |
| InitializeDefault() |
Se utiliza para inicializar un conjunto predeterminado de valores para el objeto ConfigurationElement. (Heredado de ConfigurationElement) |
| IsModified() |
Indica si se ha modificado este elemento de configuración desde la última vez en que se guardo o cargó al implementarlo en una clase derivada. (Heredado de ConfigurationElement) |
| IsReadOnly() |
Obtiene un valor que indica si el objeto ConfigurationElement es de solo lectura. (Heredado de ConfigurationElement) |
| ListErrors(IList) |
Agrega a la lista que se pasa los errores de propiedad no válida que hay en este objeto ConfigurationElement y en todos los subelementos. (Heredado de ConfigurationElement) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Obtiene un valor que indica si se ha encontrado un atributo desconocido durante la deserialización. (Heredado de ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Obtiene un valor que indica si se ha encontrado un elemento desconocido durante la deserialización. (Heredado de ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Se inicia una excepción cuando no se encuentra una propiedad necesaria. (Heredado de ConfigurationElement) |
| PostDeserialize() |
Se llama a este método después de la deserialización. (Heredado de ConfigurationElement) |
| PreSerialize(XmlWriter) |
Se llama a este método antes de la serialización. (Heredado de ConfigurationElement) |
| Reset(ConfigurationElement) |
Restablece el estado interno del objeto ConfigurationElement, incluyendo los bloqueos y las colecciones de propiedades. (Heredado de ConfigurationElement) |
| ResetModified() |
Restablece el valor del método IsModified() en |
| 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 propiedad IsReadOnly() para el objeto ConfigurationElement 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 objeto ConfigurationElement para quitar todos los valores que no se deben guardar. (Heredado de ConfigurationElement) |
