HttpListenerContext Třída

Definice

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

Metody

Platí pro

Viz také

• HttpListener
• HttpListenerRequest
• HttpListenerResponse