HttpListener Kelas
Definisi
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.
Menyediakan pendengar protokol HTTP yang sederhana dan dikontrol secara terprogram. Kelas ini tidak dapat diwariskan.
public ref class HttpListener sealed : IDisposable
public sealed class HttpListener : IDisposable
type HttpListener = class
interface IDisposable
Public NotInheritable Class HttpListener
Implements IDisposable
- Warisan
-
HttpListener
- Penerapan
Contoh
// 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
Untuk informasi selengkapnya tentang API ini, lihat Keterangan API Tambahan untuk HttpListener.
Konstruktor
HttpListener() |
Menginisialisasi instans baru kelas HttpListener. |
Properti
AuthenticationSchemes |
Mendapatkan atau mengatur skema yang digunakan untuk mengautentikasi klien. |
AuthenticationSchemeSelectorDelegate |
Mendapatkan atau mengatur delegasi yang dipanggil untuk menentukan protokol yang digunakan untuk mengautentikasi klien. |
DefaultServiceNames |
Mendapatkan daftar default Nama Penyedia Layanan (SPN) sebagaimana ditentukan oleh awalan terdaftar. |
ExtendedProtectionPolicy |
Mendapatkan atau mengatur ExtendedProtectionPolicy yang akan digunakan untuk perlindungan yang diperpanjang untuk sesi. |
ExtendedProtectionSelectorDelegate |
Mendapatkan atau mengatur delegasi yang dipanggil untuk menentukan yang akan ExtendedProtectionPolicy digunakan untuk setiap permintaan. |
IgnoreWriteExceptions |
Mendapatkan atau menetapkan Boolean nilai yang menentukan apakah aplikasi Anda menerima pengecualian yang terjadi saat HttpListener mengirim respons ke klien. |
IsListening |
Mendapatkan nilai yang menunjukkan apakah HttpListener telah dimulai. |
IsSupported |
Mendapatkan nilai yang menunjukkan apakah HttpListener dapat digunakan dengan sistem operasi saat ini. |
Prefixes |
Mendapatkan awalan Pengidentifikasi Sumber Daya Seragam (URI) yang ditangani oleh objek ini HttpListener . |
Realm |
Mendapatkan atau mengatur realm, atau partisi sumber daya, yang terkait dengan objek ini HttpListener . |
TimeoutManager |
Manajer batas waktu untuk instans ini HttpListener . |
UnsafeConnectionNtlmAuthentication |
Mendapatkan atau menetapkan Boolean nilai yang mengontrol apakah, ketika NTLM digunakan, permintaan tambahan menggunakan koneksi Protokol Kendali Transmisi (TCP) yang sama diperlukan untuk mengautentikasi. |
Metode
Abort() |
HttpListener Mematikan objek segera, membuang semua permintaan yang saat ini diantrekan. |
BeginGetContext(AsyncCallback, Object) |
Mulai mengambil permintaan masuk secara asinkron. |
Close() |
HttpListenerMematikan . |
EndGetContext(IAsyncResult) |
Menyelesaikan operasi asinkron untuk mengambil permintaan klien masuk. |
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
GetContext() |
Menunggu permintaan masuk dan kembali saat permintaan diterima. |
GetContextAsync() |
Menunggu permintaan masuk 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) |
Start() |
Memungkinkan instans ini menerima permintaan masuk. |
Stop() |
Menyebabkan instans ini berhenti menerima permintaan masuk baru dan mengakhiri pemrosesan semua permintaan yang sedang berlangsung. |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
Implementasi Antarmuka Eksplisit
IDisposable.Dispose() |
Melepaskan sumber daya yang dipegang oleh objek ini HttpListener . |