HttpListenerContext Klasa

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.HttpListener.dll

Źródło:

HttpListenerContext.cs

Zapewnia dostęp do obiektów żądania i odpowiedzi używanych przez klasę HttpListener . Klasa ta nie może być dziedziczona.

public ref class HttpListenerContext sealed

public sealed class HttpListenerContext

type HttpListenerContext = class

Public NotInheritable Class HttpListenerContext

Dziedziczenie

Object

HttpListenerContext

Przykłady

Poniższy przykład kodu 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 dotyczące 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 nie została jeszcze wysłana, i zwalnia wszystkie zasoby używane przez program HttpListenerContext. Po zamknięciu lub przerwaniu HttpListenerContext obiektu nie można odwoływać się do jego metod ani właściwości. Jeśli to zrobisz, otrzymasz ObjectDisposedException wyjątek.

Właściwości

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

AcceptWebSocketAsync(String)	Zaakceptuj połączenie protokołu WebSocket 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, 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 oraz wewnętrzny bufor jako operację asynchroniczną.
AcceptWebSocketAsync(String, TimeSpan)	Zaakceptuj połączenie protokołu WebSocket, określając obsługiwany protokół podrzędny protokołu WebSocket i interwał utrzymania aktywności protokołu WebSocket jako operację asynchroniczną.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• HttpListener
• HttpListenerRequest
• HttpListenerResponse