HttpListenerContext Class

Definition

public ref class HttpListenerContext sealed

public sealed class HttpListenerContext

type HttpListenerContext = class

Public NotInheritable Class HttpListenerContext

Inheritance

Object

HttpListenerContext

Examples

Im folgenden Codebeispiel werden die Benutzerinformationen für eine Client Anforderung angezeigt.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

Remarks

Diese Klasse stellt die Informationen im Zusammenhang mit der HTTP-Anforderung eines Clients bereit, die von einem HttpListener-Objekt verarbeitet wird.This class provides the information related to a client's Hypertext Transfer Protocol (HTTP) request being processed by an HttpListener object. Diese Klasse verfügt auch über Methoden, die einem HttpListener Objekt das akzeptieren einer WebSocket-Verbindung ermöglichen.This class also has methods that allow an HttpListener object to accept a WebSocket connection.

Die GetContext-Methode gibt Instanzen der HttpListenerContext-Klasse zurück.The GetContext method returns instances of the HttpListenerContext class. Um das-Objekt zu erhalten, das die Client Anforderung darstellt, verwenden Sie die Request-Eigenschaft.To get the object that represents the client request, use the Request property. Um das-Objekt zu erhalten, das die Antwort darstellt, die vom HttpListeneran den Client gesendet wird, verwenden Sie die Response-Eigenschaft.To get the object that represents the response that will be sent to the client by the HttpListener, use the Response property. Um Benutzerinformationen über den Client zu erhalten, der die Anforderung sendet, z. b. den Anmelde Namen und ob er authentifiziert wurde, können Sie die Eigenschaften im IPrincipal Objekt Abfragen, das von der User-Eigenschaft zurückgegeben wird.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.

Durch das Schließen eines HttpListenerContext Objekts wird die Antwort an den Client gesendet, und alle vom HttpListenerContextverwendeten Ressourcen werden freigegeben.Closing an HttpListenerContext object sends the response to the client and frees any resources used by the HttpListenerContext. Das Abbrechen eines HttpListenerContext Objekts verwirft die Antwort an den Client, wenn er noch nicht gesendet wurde, und gibt alle Ressourcen frei, die vom HttpListenerContextverwendet werden.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. Nachdem ein HttpListenerContext Objekt geschlossen oder abgebrochen wurde, ist es nicht möglich, auf seine Methoden oder Eigenschaften zu verweisen.After closing or aborting an HttpListenerContext object, you cannot reference its methods or properties. Wenn Sie dies tun, erhalten Sie eine ObjectDisposedException Ausnahme.If you do so, you will receive an ObjectDisposedException exception.

Properties

Methods

Applies to

See also

• HttpListener
• HttpListenerRequest
• HttpListenerResponse