HttpListenerContext Classe

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.HttpListener.dll

Origine:

HttpListenerContext.cs

Fornisce accesso agli oggetti richiesta e risposta utilizzati dalla classe HttpListener. La classe non può essere ereditata.

public ref class HttpListenerContext sealed

public sealed class HttpListenerContext

type HttpListenerContext = class

Public NotInheritable Class HttpListenerContext

Ereditarietà

Object

HttpListenerContext

Esempio

Nell'esempio di codice seguente vengono visualizzate le informazioni utente per una richiesta client.

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

Commenti

Questa classe fornisce le informazioni correlate alla richiesta HTTP (Hypertext Transfer Protocol) di un client elaborata da un HttpListener oggetto. Questa classe include anche metodi che consentono a un HttpListener oggetto di accettare una connessione WebSocket.

Il GetContext metodo restituisce istanze della HttpListenerContext classe. Per ottenere l'oggetto che rappresenta la richiesta client, usare la Request proprietà . Per ottenere l'oggetto che rappresenta la risposta che verrà inviata al client da HttpListener, usare la Response proprietà . Per ottenere informazioni utente sul client che invia la richiesta, ad esempio il nome di accesso e se è stato autenticato, è possibile eseguire query sulle proprietà nell'oggetto IPrincipal restituito dalla User proprietà.

La chiusura di un HttpListenerContext oggetto invia la risposta al client e libera tutte le risorse usate da HttpListenerContext. L'interruzione di un HttpListenerContext oggetto elimina la risposta al client se non è già stata inviata e libera tutte le risorse usate dall'oggetto HttpListenerContext. Dopo aver chiuso o interrotto un HttpListenerContext oggetto, non è possibile fare riferimento ai relativi metodi o proprietà. In tal caso, si riceverà un'eccezione ObjectDisposedException .

Proprietà

Request	Ottiene l'oggetto HttpListenerRequest che rappresenta la richiesta di una risorsa da parte di un client.
Response	Ottiene l'oggetto HttpListenerResponse che verrà inviato al client in risposta alla richiesta.
User	Ottiene un oggetto utilizzato per ottenere informazioni relative all'identità, all'autenticazione e ai ruoli di sicurezza per il client la cui richiesta è rappresentata da questo oggetto HttpListenerContext.

Metodi

AcceptWebSocketAsync(String)	Accettare una connessione di WebSocket come operazione asincrona.
AcceptWebSocketAsync(String, Int32, TimeSpan)	Accettare una connessione di WebSocket che specifica il protocollo secondario supportato di WebSocket, che riceve la dimensione del buffer e l'intervallo keep-alive di WebSocket come operazione asincrona.
AcceptWebSocketAsync(String, Int32, TimeSpan, ArraySegment<Byte>)	Accettare una connessione di WebSocket che specifica il protocollo secondario supportato di WebSocket e l'intervallo keep-alive di WebSocket come operazione asincrona.
AcceptWebSocketAsync(String, TimeSpan)	Accettare una connessione WebSocket che specifica il protocollo secondario WebSocket supportato e l'intervallo di conservazione di WebSocket come operazione asincrona.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• HttpListener
• HttpListenerRequest
• HttpListenerResponse