HttpListenerContext, classe

Cette classe fournit les informations relatives à la demande HTTP (Hypertext Transfer Protocol) d'un client qui est traitée par un objet HttpListener. La méthode GetContext retourne des instances de la classe HttpListenerContext. Pour obtenir l'objet qui représente la demande du client, utilisez la propriété Request. Pour obtenir l'objet représentant la réponse qui sera envoyée au client par HttpListener, utilisez la propriété Response. Pour obtenir des informations utilisateur à propos du client qui a envoyé la demande, par exemple son nom de connexion et s'il a été authentifié, vous pouvez interroger les propriétés contenues dans l'objet IPrincipal retourné par la propriété User.

La fermeture d'un objet HttpListenerContext envoie la réponse au client et libère toutes les ressources utilisées par HttpListenerContext. L'abandon d'un objet HttpListenerContext ignore la réponse au client s'il elle n'a pas encore été envoyée et libère toutes les ressources utilisées par HttpListenerContext. Après la fermeture ou l'abandon d'un objet HttpListenerContext, vous ne pouvez pas référencer ses méthodes ou propriétés. Sinon, vous recevez une exception ObjectDisposedException.

Remarque sur la plate-forme Windows XP Édition Familiale, Windows XP Professionnel Édition x64, Windows Server 2003 : Le Service Pack 2 est requis pour utiliser la classe HttpListener.

L'exemple de code suivant affiche les informations utilisateur d'une demande du client.

public static bool RemoveAllPrefixes(HttpListener listener)
{
    // Get the prefixes that the Web server is listening to.
    HttpListenerPrefixCollection prefixes = listener.Prefixes;
    try 
    {
        prefixes.Clear();
    } 
    // If the operation failed, return false.
    catch
    {
        return false;
    }
    return true;
}

Windows 98, Windows Server 2003, Windows XP Édition Media Center, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework