HttpListenerElement Classe

Définition

public ref class HttpListenerElement sealed : System::Configuration::ConfigurationElement

public sealed class HttpListenerElement : System.Configuration.ConfigurationElement

type HttpListenerElement = class
    inherit ConfigurationElement

Public NotInheritable Class HttpListenerElement
Inherits ConfigurationElement

Héritage

Object

ConfigurationElement

HttpListenerElement

Remarques

Cette classe correspond à l’élément <de configuration httpListener> Element (Network Settings). Cette classe fournit un accès programmatique aux informations qui peuvent être stockées dans des fichiers de configuration.

La UnescapeRequestUrl propriété indique si HttpListener utilise l’URI brut sans séquence d’échappement au lieu de l’URI converti où toutes les valeurs encodées en pourcentage sont converties et d’autres étapes de normalisation sont effectuées.

Lorsqu’une instance HttpListener reçoit une requête via le service http.sys, elle crée une instance de la chaîne d’URI fournie par http.sys et l’expose en tant que propriété HttpListenerRequest.Url.

Le service http.sys expose deux chaînes d’URI de requête :

• URI brut

• URI converti

L’URI brut est le System.Uri fourni dans la ligne de requête d’une requête HTTP :

GET /path/

Host: www.contoso.com

L’URI brut fourni par http.sys pour la requête mentionnée ci-dessus est « /path/ ». Cela représente la chaîne suivant le verbe HTTP tel qu’il a été envoyé sur le réseau.

Le service http.sys crée un URI converti à partir des informations fournies dans la requête à l’aide de l’URI fourni dans la ligne de requête HTTP et de l’en-tête hôte pour déterminer le serveur d’origine auquel la requête doit être transférée. Pour ce faire, les informations de la requête sont comparées à un ensemble de préfixes d’URI inscrits. La documentation du Kit de développement logiciel (SDK) du serveur HTTP fait référence à cet URI converti en tant que structure HTTP_COOKED_URL .

Pour pouvoir comparer la requête avec les préfixes d’URI inscrits, un travail de normalisation doit être effectué. Pour l’exemple ci-dessus, l’URI converti est le suivant :

http://www.contoso.com/path/

Le service http.sys combine la valeur de propriété Uri.Host et la chaîne de la ligne de requête pour créer un URI converti. En outre, http.sys et la System.Uri classe effectuent également les opérations suivantes :

• Annule l’échappement de toutes les valeurs encodées en pourcentage.

• Convertit les caractères non ASCII encodés en pourcentage en représentation de caractères UTF-16. Notez que les caractères UTF-8 et ANSI/DBCS sont pris en charge ainsi que les caractères Unicode (encodage Unicode à l’aide du format %uXXXX).

• Exécute d’autres étapes de normalisation, comme la compression de chemin d’accès.

Étant donné que la requête ne contient aucune information sur l’encodage utilisé pour les valeurs encodées en pourcentage, il peut être impossible de déterminer l’encodage correct en analysant les valeurs encodées en pourcentage.

Par conséquent http.sys fournit deux clés de Registre pour modifier le processus :

Lorsque HttpListener reçoit une requête, il utilise l’URI converti en http.sys comme entrée dans la propriété Url.

Il est nécessaire de prendre en charge certains caractères en plus des caractères et des nombres dans les URI. L’exemple d’URI suivant est utilisé pour récupérer les informations client pour le numéro de client « 1/3812 » :

http://www.contoso.com/Customer('1%2F3812')/

Notez la barre oblique encodée en pourcentage dans l’URI (%2F). Cela est nécessaire, car dans ce cas, le caractère de barre oblique représente des données et non un délimiteur de chemin d’accès.

Le passage de la chaîne au constructeur d’URI entraîne l’URI suivant :

http://www.contoso.com/Customer('1/3812')/

Le fractionnement du chemin dans ses segments produit les éléments suivants :

Customer('1

3812')

Cela ne reflète pas l’intention de l’expéditeur de la requête.

Si la propriété a la UnescapeRequestUrl valeur false, lorsque le HttpListener reçoit une requête, il utilise l’URI brut au lieu de l’URI converti de http.sys comme entrée à la Url propriété.

Constructeurs

Propriétés

Méthodes

S’applique à

Voir aussi

• HttpListener
• Url
• Schéma des paramètres réseau
• <HttpListener> , élément (paramètres réseau)