HttpListenerContext Classe

Définition

Espace de noms:

System.Net

Assembly:

System.Net.HttpListener.dll

Source:

HttpListenerContext.cs

Permet d'accéder aux objets de demande et de réponse utilisés par la classe HttpListener. Cette classe ne peut pas être héritée.

public ref class HttpListenerContext sealed

public sealed class HttpListenerContext

type HttpListenerContext = class

Public NotInheritable Class HttpListenerContext

Héritage

Object

HttpListenerContext

Exemples

L’exemple de code suivant affiche les informations utilisateur pour une demande cliente.

public static string ClientInformation(HttpListenerContext context)
{
    System.Security.Principal.IPrincipal user = context.User;
    System.Security.Principal.IIdentity id = user.Identity;
    if (id == null)
    {
        return "Client authentication is not enabled for this Web server.";
    }

    string display;
    if (id.IsAuthenticated)
    {
        display = String.Format("{0} was authenticated using {1}", id.Name,
            id.AuthenticationType);
    }
    else
    {
       display = String.Format("{0} was not authenticated", id.Name);
    }
    return display;
}

Public Shared Function ClientInformation(ByVal context As HttpListenerContext) As String
    Dim user As System.Security.Principal.IPrincipal = context.User
    Dim id As System.Security.Principal.IIdentity = user.Identity

    If id Is Nothing Then
        Return "Client authentication is not enabled for this Web server."
    End If

    Dim display As String

    If id.IsAuthenticated Then
        display = String.Format("{0} was authenticated using {1}", id.Name, id.AuthenticationType)
    Else
        display = String.Format("{0} was not authenticated", id.Name)
    End If

    Return display
End Function

Remarques

Cette classe fournit les informations relatives à la requête HTTP (Hypertext Transfer Protocol) d’un client en cours de traitement par un HttpListener objet . Cette classe a également des méthodes qui permettent à un objet d’accepter HttpListener une connexion WebSocket.

La GetContext méthode retourne des instances de la HttpListenerContext classe . Pour obtenir l’objet qui représente la demande du client, utilisez la Request propriété . Pour obtenir l’objet qui représente la réponse qui sera envoyée au client par , HttpListenerutilisez la Response propriété . Pour obtenir des informations utilisateur sur le client qui envoie la requête, telles que son nom de connexion et si elle a été authentifiée, vous pouvez interroger les propriétés dans l’objet IPrincipal retourné par la User propriété .

La fermeture d’un HttpListenerContext objet envoie la réponse au client et libère toutes les ressources utilisées par .HttpListenerContext L’abandon d’un HttpListenerContext objet ignore la réponse au client s’il n’a pas déjà été envoyé et libère toutes les ressources utilisées par le HttpListenerContext. Après avoir fermé ou abandonné un HttpListenerContext objet, vous ne pouvez pas référencer ses méthodes ou propriétés. Si vous procédez ainsi, vous recevrez une ObjectDisposedException exception.

Propriétés

Request	Obtient le HttpListenerRequest qui représente la demande de ressource par un client.
Response	Obtient l'objet HttpListenerResponse qui sera envoyé au client en réponse à sa demande.
User	Obtient un objet utilisé pour obtenir l'identité, les informations d'authentification et les rôles de sécurité du client dont la demande est représentée par cet objet HttpListenerContext.

Méthodes

AcceptWebSocketAsync(String)	Accepte une connexion WebSocket en tant qu'opération asynchrone.
AcceptWebSocketAsync(String, Int32, TimeSpan)	Accepte une connexion WebSocket spécifiant le sous-protocole WebSocket pris en charge, reçoit la taille de la mémoire tampon et l'intervalle de WebSocket pendant lequel maintenir l'activité en tant qu'opération asynchrone.
AcceptWebSocketAsync(String, Int32, TimeSpan, ArraySegment<Byte>)	Accepte une connexion de WebSocket spécifiant le sous-protocole WebSocket pris en charge, reçoit la taille de la mémoire tampon, l'intervalle de WebSocket pendant lequel maintenir l'activité et la mémoire tampon interne en tant qu'opération asynchrone.
AcceptWebSocketAsync(String, TimeSpan)	Acceptez une connexion WebSocket spécifiant le sous-protocole WebSocket pris en charge et l’intervalle de conservation webSocket en tant qu’opération asynchrone.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• HttpListener
• HttpListenerRequest
• HttpListenerResponse