Compartir a través de

<Elemento httpListener> (Configuración de red)

  • Artículo

Personaliza los parámetros utilizados por la clase HttpListener.

<configuración>
  <system.net>
    <configuración>
      <httpListener>

Sintaxis

<httpListener  
  unescapeRequestUrl="true|false"  
/>

Tipo

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo Descripción
unescapeRequestUrl Valor booleano que indica si una instancia HttpListener utiliza el URI sin secuencias de escape y sin formato en lugar del URI convertido.

Elementos secundarios

Ninguno.

Elementos primarios

Element Descripción
settings Configura opciones de red básicas para el espacio de nombres System.Net.

Comentarios

El atributo unescapeRequestUrl indica si HttpListener usa el URI sin escape y sin formato 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 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 clase System.Uri también hace 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 el atributo unescapeRequestUrl se establece en false, cuando HttpListener recibe una solicitud, usa el URI sin formato en lugar del URI convertido de http.sys como entrada en la propiedad Url.

El valor predeterminado del atributo unescapeRequestUrl es true.

La propiedad UnescapeRequestUrl se puede usar para obtener el valor actual del atributo unescapeRequestUrl de los archivos de configuración aplicables.

Ejemplo

En el ejemplo siguiente se muestra cómo configurar la clase HttpListener cuando recibe una solicitud para usar el URI sin formato en lugar del URI convertido de http.sys como entrada a la propiedad Url.

<configuration>  
  <system.net>  
    <settings>  
      <httpListener  
        unescapeRequestUrl="false"  
      />  
    </settings>  
  </system.net>  
</configuration>

Información de elemento

Namespace: System.Net

Consulte también