HttpListenerContext HttpListenerContext HttpListenerContext HttpListenerContext Class

Definizione

Fornisce accesso agli oggetti richiesta e risposta utilizzati dalla classe HttpListener.Provides access to the request and response objects used by the HttpListener class. Questa classe non può essere ereditata.This class cannot be inherited.

public ref class HttpListenerContext sealed
public sealed class HttpListenerContext
type HttpListenerContext = class
Public NotInheritable Class HttpListenerContext
Ereditarietà
HttpListenerContextHttpListenerContextHttpListenerContextHttpListenerContext

Esempi

Nell'esempio di codice seguente vengono visualizzate le informazioni sull'utente per una richiesta client.The following code example displays the user information for a client request.

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 a una richiesta Hypertext Transfer Protocol (http) del client elaborata da un HttpListener oggetto.This class provides the information related to a client's Hypertext Transfer Protocol (HTTP) request being processed by an HttpListener object. Questa classe dispone anche di metodi che consentono HttpListener a un oggetto di accettare una connessione WebSocket.This class also has methods that allow an HttpListener object to accept a WebSocket connection.

Il GetContext metodo restituisce istanze HttpListenerContext della classe.The GetContext method returns instances of the HttpListenerContext class. Per ottenere l'oggetto che rappresenta la richiesta del client, usare Request la proprietà.To get the object that represents the client request, use the Request property. Per ottenere l'oggetto che rappresenta la risposta che verrà inviata al client da HttpListener, utilizzare la Response proprietà.To get the object that represents the response that will be sent to the client by the HttpListener, use the Response property. Per ottenere informazioni sull'utente sul client che invia la richiesta, ad esempio il nome dell'account di accesso e se è stata autenticata, è possibile eseguire una IPrincipal query sulle proprietà nell' User oggetto restituito dalla proprietà.To get user information about the client sending the request, such as its login name and whether it has been authenticated, you can query the properties in the IPrincipal object returned by the User property.

La chiusura HttpListenerContext di un oggetto Invia la risposta al client e libera tutte le risorse usate HttpListenerContextda.Closing an HttpListenerContext object sends the response to the client and frees any resources used by the HttpListenerContext. L'interruzione di HttpListenerContext un oggetto elimina la risposta al client, se non è già stata inviata, e libera le risorse usate HttpListenerContextda.Aborting an HttpListenerContext object discards the response to the client if it has not already been sent, and frees any resources used by the HttpListenerContext. Dopo la chiusura o l'interruzione HttpListenerContext di un oggetto, non è possibile fare riferimento ai relativi metodi o proprietà.After closing or aborting an HttpListenerContext object, you cannot reference its methods or properties. In tal caso, viene generata un' ObjectDisposedException eccezione.If you do so, you will receive an ObjectDisposedException exception.

Proprietà

Request Request Request Request

Ottiene l'oggetto HttpListenerRequest che rappresenta la richiesta di una risorsa da parte di un client.Gets the HttpListenerRequest that represents a client's request for a resource.

Response Response Response Response

Ottiene l'oggetto HttpListenerResponse che verrà inviato al client in risposta alla richiesta.Gets the HttpListenerResponse object that will be sent to the client in response to the client's request.

User User User 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.Gets an object used to obtain identity, authentication information, and security roles for the client whose request is represented by this HttpListenerContext object.

Metodi

AcceptWebSocketAsync(String) AcceptWebSocketAsync(String) AcceptWebSocketAsync(String) AcceptWebSocketAsync(String)

Accettare una connessione di WebSocket come operazione asincrona.Accept a WebSocket connection as an asynchronous operation.

AcceptWebSocketAsync(String, Int32, TimeSpan) AcceptWebSocketAsync(String, Int32, TimeSpan) AcceptWebSocketAsync(String, Int32, TimeSpan) 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.Accept a WebSocket connection specifying the supported WebSocket sub-protocol, receive buffer size, and WebSocket keep-alive interval as an asynchronous operation.

AcceptWebSocketAsync(String, Int32, TimeSpan, ArraySegment<Byte>) AcceptWebSocketAsync(String, Int32, TimeSpan, ArraySegment<Byte>) AcceptWebSocketAsync(String, Int32, TimeSpan, ArraySegment<Byte>) 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.Accept a WebSocket connection specifying the supported WebSocket sub-protocol, receive buffer size, WebSocket keep-alive interval, and the internal buffer as an asynchronous operation.

AcceptWebSocketAsync(String, TimeSpan) AcceptWebSocketAsync(String, TimeSpan) AcceptWebSocketAsync(String, TimeSpan) AcceptWebSocketAsync(String, TimeSpan)

Accettare una connessione di WebSocket che specifica il protocollo secondario supportato di WebSocket e l'intervallo keep-alive di WebSocket come operazione asincrona.Accept a WebSocket connection specifying the supported WebSocket sub-protocol and WebSocket keep-alive interval as an asynchronous operation.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Si applica a

Vedi anche