HttpListenerContext Kelas

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.HttpListener.dll

Sumber:

HttpListenerContext.cs

Menyediakan akses ke objek permintaan dan respons yang digunakan oleh HttpListener kelas . Kelas ini tidak dapat diwariskan.

public ref class HttpListenerContext sealed

public sealed class HttpListenerContext

type HttpListenerContext = class

Public NotInheritable Class HttpListenerContext

Warisan

Object

HttpListenerContext

Contoh

Contoh kode berikut menampilkan informasi pengguna untuk permintaan klien.

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

Keterangan

Kelas ini menyediakan informasi yang terkait dengan permintaan Hypertext Transfer Protocol (HTTP) klien yang HttpListener sedang diproses oleh objek. Kelas ini juga memiliki metode yang memungkinkan HttpListener objek untuk menerima koneksi WebSocket.

Metode mengembalikan GetContext instans HttpListenerContext kelas . Untuk mendapatkan objek yang mewakili permintaan klien, gunakan Request properti . Untuk mendapatkan objek yang mewakili respons yang akan dikirim ke klien oleh HttpListener, gunakan Response properti . Untuk mendapatkan informasi pengguna tentang klien yang mengirim permintaan, seperti nama masuknya dan apakah telah diautentikasi, Anda dapat mengkueri properti di objek yang IPrincipal dikembalikan oleh User properti .

HttpListenerContext Menutup objek mengirimkan respons ke klien dan membebaskan sumber daya apa pun yang HttpListenerContextdigunakan oleh . Membatalkan HttpListenerContext objek akan membuang respons terhadap klien jika belum dikirim, dan membebaskan sumber daya apa pun yang HttpListenerContextdigunakan oleh . Setelah menutup atau membatalkan HttpListenerContext objek, Anda tidak dapat mereferensikan metode atau propertinya. Jika Anda melakukannya, Anda akan menerima ObjectDisposedException pengecualian.

Properti

Request	HttpListenerRequest Mendapatkan yang mewakili permintaan klien untuk sumber daya.
Response	HttpListenerResponse Mendapatkan objek yang akan dikirim ke klien sebagai respons terhadap permintaan klien.
User	Mendapatkan objek yang digunakan untuk mendapatkan peran identitas, informasi autentikasi, dan keamanan untuk klien yang permintaannya diwakili oleh objek ini HttpListenerContext .

Metode

AcceptWebSocketAsync(String)	Terima koneksi WebSocket sebagai operasi asinkron.
AcceptWebSocketAsync(String, Int32, TimeSpan)	Terima koneksi WebSocket yang menentukan sub-protokol WebSocket yang didukung, menerima ukuran buffer, dan interval tetap aktif WebSocket sebagai operasi asinkron.
AcceptWebSocketAsync(String, Int32, TimeSpan, ArraySegment<Byte>)	Terima koneksi WebSocket yang menentukan sub-protokol WebSocket yang didukung, menerima ukuran buffer, interval tetap aktif WebSocket, dan buffer internal sebagai operasi asinkron.
AcceptWebSocketAsync(String, TimeSpan)	Terima koneksi WebSocket yang menentukan sub-protokol WebSocket yang didukung dan interval tetap aktif WebSocket sebagai operasi asinkron.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• HttpListener
• HttpListenerRequest
• HttpListenerResponse