HttpListener.GetContext Metode

Referensi

Definisi

Ruang nama:: System.Net

Rakitan:: System.Net.HttpListener.dll

Rakitan:: System.dll

Rakitan:: netstandard.dll

Sumber:: HttpListener.Managed.cs

Sumber:: HttpListener.Managed.cs

Sumber:: HttpListener.Managed.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.

Menunggu permintaan masuk dan kembali saat permintaan diterima.

public:
 System::Net::HttpListenerContext ^ GetContext();

public System.Net.HttpListenerContext GetContext ();

member this.GetContext : unit -> System.Net.HttpListenerContext

Public Function GetContext () As HttpListenerContext

Mengembalikan

HttpListenerContext

Objek HttpListenerContext yang mewakili permintaan klien.

Pengecualian

HttpListenerException

Panggilan fungsi Win32 gagal. Periksa properti pengecualian ErrorCode untuk menentukan penyebab pengecualian.

InvalidOperationException

Objek ini belum dimulai atau saat ini dihentikan.

-atau-

HttpListener tidak memiliki awalan Pengidentifikasi Sumber Daya Seragam (URI) untuk ditanggapi.

ObjectDisposedException

Objek ini ditutup.

Contoh

Contoh kode berikut menunjukkan panggilan metode ini.

// 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

Sebelum memanggil metode ini, Anda harus memanggil Start metode dan menambahkan setidaknya satu awalan URI untuk didengarkan dengan menambahkan string URI ke HttpListenerPrefixCollection yang dikembalikan oleh Prefixes properti . Untuk deskripsi terperinci tentang awalan, lihat HttpListener gambaran umum kelas.

Metode ini memblokir saat menunggu permintaan masuk. Jika Anda ingin permintaan masuk diproses secara asinkron (pada utas terpisah) sehingga aplikasi Anda tidak memblokir, gunakan metode .BeginGetContext

Catatan Bagi Pemanggil

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Berlaku untuk

Share via