HttpListenerContext Klasa

Definicja

Przestrzeń nazw:

System.Net

Zestawy:

netstandard.dll, System.Net.HttpListener.dll

Źródło:

HttpListenerContext.cs

Zapewnia dostęp do obiektów żądania i odpowiedzi używanych przez klasę HttpListener . Tej klasy nie można dziedziczyć.

public ref class HttpListenerContext sealed

public sealed class HttpListenerContext

type HttpListenerContext = class

Public NotInheritable Class HttpListenerContext

Dziedziczenie

Object

HttpListenerContext

Przykłady

Poniższy przykładowy kod przedstawia informacje o użytkowniku dla żądania klienta.

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

Uwagi

Ta klasa zawiera informacje związane z żądaniem http (Hypertext Transfer Protocol) klienta przetwarzanym HttpListener przez obiekt. Ta klasa zawiera również metody, które umożliwiają HttpListener obiektowi akceptowanie połączenia protokołu WebSocket.

Metoda GetContext zwraca wystąpienia HttpListenerContext klasy . Aby uzyskać obiekt reprezentujący żądanie klienta, użyj Request właściwości . Aby uzyskać obiekt reprezentujący odpowiedź, która zostanie wysłana do klienta przez HttpListenerobiekt , użyj Response właściwości . Aby uzyskać informacje o użytkowniku dotyczące klienta wysyłającego żądanie, takie jak jego nazwa logowania i czy zostało uwierzytelnione, możesz wykonać zapytanie o właściwości w IPrincipal obiekcie zwróconym User przez właściwość.

HttpListenerContext Zamknięcie obiektu wysyła odpowiedź do klienta i zwalnia wszystkie zasoby używane przez program HttpListenerContext. Przerwanie HttpListenerContext obiektu odrzuca odpowiedź na klienta, jeśli jeszcze nie została wysłana, i zwalnia wszystkie zasoby używane przez program HttpListenerContext. Po zamknięciu lub przerwaniu HttpListenerContext obiektu nie można odwołać się do jego metod ani właściwości. Jeśli to zrobisz, otrzymasz ObjectDisposedException wyjątek.

Właściwości

Nazwa	Opis
Request	Pobiera element HttpListenerRequest reprezentujący żądanie klienta dla zasobu.
Response	HttpListenerResponse Pobiera obiekt, który zostanie wysłany do klienta w odpowiedzi na żądanie klienta.
User	Pobiera obiekt używany do uzyskiwania tożsamości, informacji o uwierzytelnianiu i ról zabezpieczeń dla klienta, którego żądanie jest reprezentowane przez ten HttpListenerContext obiekt.

Metody

Nazwa	Opis
AcceptWebSocketAsync(String, Int32, TimeSpan, ArraySegment<Byte>)	Zaakceptuj połączenie protokołu WebSocket określające obsługiwany protokół podrzędny protokołu WebSocket, rozmiar buforu odbierania, interwał utrzymania aktywności protokołu WebSocket i wewnętrzny bufor jako operację asynchroniczną.
AcceptWebSocketAsync(String, Int32, TimeSpan)	Zaakceptuj połączenie protokołu WebSocket określające obsługiwany protokół podrzędny protokołu WebSocket, rozmiar buforu odbierania i interwał utrzymania aktywności protokołu WebSocket jako operację asynchroniczną.
AcceptWebSocketAsync(String, TimeSpan)	Zaakceptuj połączenie protokołu WebSocket określające obsługiwany protokół podrzędny protokołu WebSocket i interwał utrzymania aktywności protokołu WebSocket jako operację asynchroniczną.
AcceptWebSocketAsync(String)	Zaakceptuj połączenie protokołu WebSocket jako operację asynchroniczną.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• HttpListener
• HttpListenerRequest
• HttpListenerResponse