HttpListenerContext Třída

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.HttpListener.dll

Zdroj:

HttpListenerContext.cs

Poskytuje přístup k objektům požadavků a odpovědí používaných HttpListener třídou . Tato třída se nemůže dědit.

public ref class HttpListenerContext sealed

public sealed class HttpListenerContext

type HttpListenerContext = class

Public NotInheritable Class HttpListenerContext

Dědičnost

Object

HttpListenerContext

Příklady

Následující příklad kódu zobrazí informace o uživateli pro požadavek 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

Poznámky

Tato třída poskytuje informace související s požadavky http (Hypertext Transfer Protocol) klienta zpracovávané objektem HttpListener . Tato třída obsahuje také metody, které objektu HttpListener umožňují přijmout připojení WebSocket.

Metoda GetContext vrací instance HttpListenerContext třídy . K získání objektu, který představuje požadavek klienta, použijte Request vlastnost . Pokud chcete získat objekt, který představuje odpověď, která bude odeslána klientovi HttpListener, použijte Response vlastnost . Pokud chcete získat informace o uživateli o klientovi odesílajícím požadavek, jako je jeho přihlašovací jméno a jestli byl ověřen, můžete zadat dotaz na vlastnosti objektu IPrincipal vráceného User vlastností.

Při zavření objektu HttpListenerContext se klientovi odešle odpověď a uvolní se všechny prostředky používané objektem HttpListenerContext. Přerušení objektu HttpListenerContext zahodí odpověď klientovi, pokud ještě nebyla odeslána, a uvolní všechny prostředky, které HttpListenerContextpoužívá . Po zavření nebo přerušení objektu HttpListenerContext nelze odkazovat na jeho metody nebo vlastnosti. Pokud to uděláte, obdržíte výjimku ObjectDisposedException .

Vlastnosti

Request	Získá , HttpListenerRequest který představuje požadavek klienta na prostředek.
Response	HttpListenerResponse Získá objekt, který bude odeslán klientovi v reakci na požadavek klienta.
User	Získá objekt používaný k získání identity, ověřovacích informací a rolí zabezpečení pro klienta, jehož požadavek je reprezentován tímto HttpListenerContext objektem.

Metody

AcceptWebSocketAsync(String)	Přijměte připojení WebSocket jako asynchronní operaci.
AcceptWebSocketAsync(String, Int32, TimeSpan)	Přijměte připojení WebSocket určující podporovaný dílčí protokol WebSocket, velikost vyrovnávací paměti pro příjem a interval udržování protokolu WebSocket jako asynchronní operaci.
AcceptWebSocketAsync(String, Int32, TimeSpan, ArraySegment<Byte>)	Přijměte připojení WebSocket určující podporovaný dílčí protokol WebSocket, velikost vyrovnávací paměti příjmu, interval udržování protokolu WebSocket a interní vyrovnávací paměť jako asynchronní operaci.
AcceptWebSocketAsync(String, TimeSpan)	Přijměte připojení WebSocket určující podporovaný dílčí protokol WebSocket a interval udržování protokolu WebSocket jako asynchronní operaci.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• HttpListener
• HttpListenerRequest
• HttpListenerResponse