HttpListenerContext Klasse

Referenz

Definition

Namespace:: System.Net

Assembly:: System.Net.HttpListener.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Quelle:: HttpListenerContext.cs

Quelle:: HttpListenerContext.cs

Quelle:: HttpListenerContext.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ermöglicht den Zugriff auf die von der HttpListener-Klasse verwendeten Anforderungs- und Antwortobjekte. Diese Klasse kann nicht vererbt werden.

public ref class HttpListenerContext sealed

public sealed class HttpListenerContext

type HttpListenerContext = class

Public NotInheritable Class HttpListenerContext

Vererbung: Object
HttpListenerContext

Beispiele

Im folgenden Codebeispiel werden die Benutzerinformationen für eine Clientanforderung angezeigt.

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

Hinweise

Diese Klasse stellt die Informationen im Zusammenhang mit der HTTP-Anforderung (Hypertext Transfer Protocol) eines Clients bereit, die von einem HttpListener -Objekt verarbeitet wird. Diese Klasse verfügt auch über Methoden, die es einem HttpListener Objekt ermöglichen, eine WebSocket-Verbindung zu akzeptieren.

Die GetContext -Methode gibt Instanzen der HttpListenerContext -Klasse zurück. Verwenden Sie die -Eigenschaft, um das Objekt abzurufen, das die Request Clientanforderung darstellt. Verwenden Sie die -Eigenschaft, um das -Objekt abzurufen, das die Antwort darstellt, die von an den HttpListener Response Client gesendet wird. Um Benutzerinformationen über den Client abzurufen, der die Anforderung sendet, z. B. seinen Anmeldenamen und ob sie authentifiziert wurde, können Sie die Eigenschaften des von der IPrincipal User -Eigenschaft zurückgegebenen Objekts abfragen.

Das Schließen eines HttpListenerContext Objekts sendet die Antwort an den Client und gibt alle ressourcen frei, die HttpListenerContextvon verwendet werden. Durch das Abbrechen eines HttpListenerContext Objekts wird die Antwort an den Client verworfen, wenn sie noch nicht gesendet wurde, und alle ressourcen werden freigegeben, die HttpListenerContextvon verwendet werden. Nach dem Schließen oder Abbrechen eines HttpListenerContext Objekts können Sie nicht auf seine Methoden oder Eigenschaften verweisen. Wenn Sie dies tun, erhalten Sie eine ObjectDisposedException Ausnahme.

Eigenschaften

Request	Ruft die HttpListenerRequest ab, die die Anforderung eines Clients für eine Ressource darstellt.
Response	Ruft das HttpListenerResponse-Objekt ab, das als Antwort auf die Anforderung des Clients an den Client gesendet wird.
User	Ruft ein Objekt ab, das zum Abrufen von Identitäts- und Sicherheitsinformationen sowie von Sicherheitsrollen für den Client verwendet wird, dessen Anforderung durch dieses HttpListenerContext-Objekt dargestellt wird.

Methoden

AcceptWebSocketAsync(String)	Nehmen Sie eine WebSocket-Verbindung als asynchroner Vorgang an.
AcceptWebSocketAsync(String, Int32, TimeSpan)	Nehmen Sie eine WebSocket-Verbindung an, die das unterstützte WebSocket-Unterprotokoll, empfangene Puffergröße und das WebSocket Keep-Alive-Intervall als asynchroner Vorgang angibt.
AcceptWebSocketAsync(String, Int32, TimeSpan, ArraySegment<Byte>)	Nehmen Sie eine WebSocket-Verbindung an, die das unterstützte WebSocket-Unterprotokoll, empfangene Puffergröße, das WebSocket Keep-Alive-Intervall und den internen Puffer als asynchroner Vorgang angibt.
AcceptWebSocketAsync(String, TimeSpan)	Akzeptieren Sie eine WebSocket-Verbindung, die das unterstützte WebSocket-Unterprotokoll und das WebSocket-Keep-Alive-Intervall als asynchronen Vorgang angibt.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für:

Freigeben über