HttpListenerRequest Kelas

Referensi

Definisi

Ruang nama:: System.Net

Rakitan:: System.Net.HttpListener.dll

Rakitan:: System.dll

Rakitan:: netstandard.dll

Sumber:: HttpListenerRequest.cs

Sumber:: HttpListenerRequest.cs

Sumber:: HttpListenerRequest.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menjelaskan permintaan HTTP masuk ke HttpListener objek. Kelas ini tidak dapat diwariskan.

public ref class HttpListenerRequest sealed

public sealed class HttpListenerRequest

type HttpListenerRequest = class

Public NotInheritable Class HttpListenerRequest

Warisan: Object
HttpListenerRequest

Contoh

Contoh kode berikut menunjukkan cara menerima dan merespons HttpListenerRequest.

// This example requires the System and System.Net namespaces.
public static void SimpleListenerExample(string[] prefixes)
{
    if (!HttpListener.IsSupported)
    {
        Console.WriteLine ("Windows XP SP2 or Server 2003 is required to use the HttpListener class.");
        return;
    }
    // URI prefixes are required,
    // for example "http://contoso.com:8080/index/".
    if (prefixes == null || prefixes.Length == 0)
      throw new ArgumentException("prefixes");

    // Create a listener.
    HttpListener listener = new HttpListener();
    // Add the prefixes.
    foreach (string s in prefixes)
    {
        listener.Prefixes.Add(s);
    }
    listener.Start();
    Console.WriteLine("Listening...");
    // Note: The GetContext method blocks while waiting for a request.
    HttpListenerContext context = listener.GetContext();
    HttpListenerRequest request = context.Request;
    // Obtain a response object.
    HttpListenerResponse response = context.Response;
    // Construct a response.
    string responseString = "<HTML><BODY> Hello world!</BODY></HTML>";
    byte[] buffer = System.Text.Encoding.UTF8.GetBytes(responseString);
    // Get a response stream and write the response to it.
    response.ContentLength64 = buffer.Length;
    System.IO.Stream output = response.OutputStream;
    output.Write(buffer,0,buffer.Length);
    // You must close the output stream.
    output.Close();
    listener.Stop();
}

Public Shared Sub SimpleListenerExample(prefixes As String())
    If Not HttpListener.IsSupported Then
        Console.WriteLine("Windows XP SP2 or Server 2003 is required to use the HttpListener class.")
        Return
    End If
    ' URI prefixes are required,
    ' for example "http://contoso.com:8080/index/".
    If prefixes Is Nothing Or prefixes.Length = 0 Then
        Throw New ArgumentException("prefixes")
    End If

    ' Create a listener
    Dim listener = New HttpListener()

    For Each s As String In prefixes
        listener.Prefixes.Add(s)
    Next
    listener.Start()
    Console.WriteLine("Listening...")
    ' Note: The GetContext method blocks while waiting for a request.
    Dim context As HttpListenerContext = listener.GetContext()
    Console.WriteLine("Listening...")
    ' Obtain a response object
    Dim request As HttpListenerRequest = context.Request
    ' Construct a response.
    Dim response As HttpListenerResponse = context.Response
    Dim responseString As String = "<HTML><BODY> Hello world!</BODY></HTML>"
    Dim buffer As Byte() = System.Text.Encoding.UTF8.GetBytes(responseString)
    ' Get a response stream and write the response to it.
    response.ContentLength64 = buffer.Length
    Dim output As System.IO.Stream = response.OutputStream
    output.Write(buffer, 0, buffer.Length)
    'You must close the output stream.
    output.Close()
    listener.Stop()
End Sub

Keterangan

Ketika klien membuat permintaan ke Pengidentifikasi Sumber Daya Seragam (URI) yang HttpListener ditangani oleh objek, HttpListener menyediakan HttpListenerContext objek yang berisi informasi tentang pengirim, permintaan, dan respons yang dikirim ke klien. Properti HttpListenerContext.Request mengembalikan HttpListenerRequest objek yang menjelaskan permintaan.

Objek HttpListenerRequest berisi informasi tentang permintaan, seperti string permintaan HttpMethod , UserAgent string, dan data isi permintaan (lihat InputStream properti ).

Untuk membalas permintaan, Anda harus mendapatkan respons terkait menggunakan Response properti .

Properti

AcceptTypes	Mendapatkan jenis MIME yang diterima oleh klien.
ClientCertificateError	Mendapatkan kode kesalahan yang mengidentifikasi masalah dengan yang X509Certificate disediakan oleh klien.
ContentEncoding	Mendapatkan pengodean konten yang dapat digunakan dengan data yang dikirim dengan permintaan.
ContentLength64	Mendapatkan panjang data isi yang disertakan dalam permintaan.
ContentType	Mendapatkan jenis MIME dari data isi yang disertakan dalam permintaan.
Cookies	Mendapatkan cookie yang dikirim dengan permintaan.
HasEntityBody	Boolean Mendapatkan nilai yang menunjukkan apakah permintaan memiliki data isi terkait.
Headers	Mendapatkan kumpulan pasangan nama/nilai header yang dikirim dalam permintaan.
HttpMethod	Mendapatkan metode HTTP yang ditentukan oleh klien.
InputStream	Mendapatkan aliran yang berisi data isi yang dikirim oleh klien.
IsAuthenticated	Boolean Mendapatkan nilai yang menunjukkan apakah klien yang mengirim permintaan ini diautentikasi.
IsLocal	Boolean Mendapatkan nilai yang menunjukkan apakah permintaan dikirim dari komputer lokal.
IsSecureConnection	Boolean Mendapatkan nilai yang menunjukkan apakah koneksi TCP yang digunakan untuk mengirim permintaan menggunakan protokol Secure Sockets Layer (SSL).
IsWebSocketRequest	Boolean Mendapatkan nilai yang menunjukkan apakah koneksi TCP adalah permintaan WebSocket.
KeepAlive	Boolean Mendapatkan nilai yang menunjukkan apakah klien meminta koneksi persisten.
LocalEndPoint	Mendapatkan alamat IP server dan nomor port tempat permintaan diarahkan.
ProtocolVersion	Mendapatkan versi HTTP yang digunakan oleh klien yang meminta.
QueryString	Mendapatkan string kueri yang disertakan dalam permintaan.
RawUrl	Mendapatkan informasi URL (tanpa host dan port) yang diminta oleh klien.
RemoteEndPoint	Mendapatkan alamat IP klien dan nomor port tempat permintaan berasal.
RequestTraceIdentifier	Mendapatkan pengidentifikasi permintaan permintaan HTTP masuk.
ServiceName	Mendapatkan Nama Penyedia Layanan (SPN) yang dikirim klien atas permintaan.
TransportContext	TransportContext Mendapatkan untuk permintaan klien.
Url	Mendapatkan objek yang Uri diminta oleh klien.
UrlReferrer	Mendapatkan Pengidentifikasi Sumber Daya Seragam (URI) dari sumber daya yang merujuk klien ke server.
UserAgent	Mendapatkan agen pengguna yang disajikan oleh klien.
UserHostAddress	Mendapatkan alamat IP server dan nomor port tempat permintaan diarahkan.
UserHostName	Mendapatkan nama DNS dan, jika disediakan, nomor port yang ditentukan oleh klien.
UserLanguages	Mendapatkan bahasa alami yang lebih disukai untuk respons.

Metode

BeginGetClientCertificate(AsyncCallback, Object)	Memulai permintaan asinkron untuk sertifikat X.509 v.3 klien.
EndGetClientCertificate(IAsyncResult)	Mengakhiri permintaan asinkron untuk sertifikat X.509 v.3 klien.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetClientCertificate()	Mengambil sertifikat X.509 v.3 klien.
GetClientCertificateAsync()	Mengambil sertifikat X.509 v.3 klien sebagai operasi asinkron.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Berlaku untuk

Bagikan melalui