HttpListenerElement.UnescapeRequestUrl Propiedad

Definición

Espacio de nombres:

System.Net.Configuration

Ensamblado:

System.dll

Obtiene un valor que indica si HttpListener usa el URI sin secuencias de escape y sin formato en lugar del URI convertido.

public:
 property bool UnescapeRequestUrl { bool get(); };

[System.Configuration.ConfigurationProperty("unescapeRequestUrl", DefaultValue=true, IsRequired=false)]
public bool UnescapeRequestUrl { get; }

[<System.Configuration.ConfigurationProperty("unescapeRequestUrl", DefaultValue=true, IsRequired=false)>]
member this.UnescapeRequestUrl : bool

Public ReadOnly Property UnescapeRequestUrl As Boolean

Valor de propiedad

Boolean

Valor booleano que indica si HttpListener usa el URI sin secuencias de escape y sin formato en lugar del URI convertido.

Atributos

ConfigurationPropertyAttribute

Comentarios

La UnescapeRequestUrl propiedad indica si HttpListener usa el URI sin formato sin escape en lugar del URI convertido donde se convierten los valores codificados por porcentajes 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 procesar en lugar del URI convertido de http.sys como entrada a la Url propiedad .

Consulte también

• HttpListener
• Url
• Esquema de la configuración de red
• <Elemento httpListener> (Configuración de red)