HttpListenerContext Sınıf

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.HttpListener.dll

Kaynak:

HttpListenerContext.cs

sınıfı tarafından kullanılan istek ve yanıt nesnelerine HttpListener erişim sağlar. Bu sınıf devralınamaz.

public ref class HttpListenerContext sealed

public sealed class HttpListenerContext

type HttpListenerContext = class

Public NotInheritable Class HttpListenerContext

Devralma

Object

HttpListenerContext

Örnekler

Aşağıdaki kod örneği, bir istemci isteğinin kullanıcı bilgilerini görüntüler.

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

Açıklamalar

Bu sınıf, bir nesne tarafından işlenen istemcinin Köprü Metni Aktarım Protokolü (HTTP) isteğiyle HttpListener ilgili bilgileri sağlar. Bu sınıf ayrıca bir HttpListener nesnenin WebSocket bağlantısını kabul etmesine izin veren yöntemlere de sahiptir.

GetContext yöntemi sınıfının örneklerini HttpListenerContext döndürür. İstemci isteğini temsil eden nesneyi almak için özelliğini kullanın Request . tarafından HttpListeneristemciye gönderilecek yanıtı temsil eden nesneyi almak için özelliğini kullanın Response . İsteği gönderen istemci hakkında oturum açma adı ve kimlik doğrulaması yapılıp yapılmadığı gibi kullanıcı bilgilerini almak için özelliği tarafından User döndürülen nesnedeki IPrincipal özellikleri sorgulayabilirsiniz.

Bir HttpListenerContext nesneyi kapatmak istemciye yanıt gönderir ve tarafından HttpListenerContextkullanılan tüm kaynakları serbest eder. Bir HttpListenerContext nesnenin durdurulması, henüz gönderilmemişse istemciye verilen yanıtı atar ve tarafından kullanılan tüm kaynakları boşaltır HttpListenerContext. Bir HttpListenerContext nesneyi kapattıktan veya durdurduktan sonra yöntemlerine veya özelliklerine başvuramazsınız. Bunu yaparsanız, bir ObjectDisposedException özel durum alırsınız.

Özellikler

Request	İstemcinin HttpListenerRequest kaynak isteğini temsil eden öğesini alır.
Response	İstemcinin HttpListenerResponse isteğine yanıt olarak istemciye gönderilecek nesneyi alır.
User	İsteği bu HttpListenerContext nesneyle temsil edilen istemci için kimlik, kimlik doğrulama bilgileri ve güvenlik rollerini almak için kullanılan bir nesneyi alır.

Yöntemler

AcceptWebSocketAsync(String)	WebSocket bağlantısını zaman uyumsuz bir işlem olarak kabul edin.
AcceptWebSocketAsync(String, Int32, TimeSpan)	Desteklenen WebSocket alt protokollerini, alma arabellek boyutunu ve WebSocket etkin tutma aralığını zaman uyumsuz bir işlem olarak belirten bir WebSocket bağlantısını kabul edin.
AcceptWebSocketAsync(String, Int32, TimeSpan, ArraySegment<Byte>)	Desteklenen WebSocket alt protokollerini belirten bir WebSocket bağlantısını kabul edin, arabellek boyutunu, WebSocket etkin tutma aralığını ve iç arabelleği zaman uyumsuz bir işlem olarak alın.
AcceptWebSocketAsync(String, TimeSpan)	Desteklenen WebSocket alt protokol ve WebSocket etkin tutma aralığını zaman uyumsuz bir işlem olarak belirten bir WebSocket bağlantısını kabul edin.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• HttpListener
• HttpListenerRequest
• HttpListenerResponse