HttpListener Sınıf

Tanım

Program aracılığıyla denetlenen basit bir HTTP protokolü dinleyicisi sağlar. Bu sınıf devralınamaz.

public ref class HttpListener sealed : IDisposable
public sealed class HttpListener : IDisposable
type HttpListener = class
    interface IDisposable
Public NotInheritable Class HttpListener
Implements IDisposable
Devralma
HttpListener
Uygulamalar

Örnekler

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

Açıklamalar

Bu API hakkında daha fazla bilgi için bkz . HttpListener için ek API açıklamaları.

Oluşturucular

HttpListener()

HttpListener sınıfının yeni bir örneğini başlatır.

Özellikler

AuthenticationSchemes

İstemcilerin kimliğini doğrulamak için kullanılan düzeni alır veya ayarlar.

AuthenticationSchemeSelectorDelegate

İstemcilerin kimliğini doğrulamak için kullanılan protokolü belirlemek için çağrılan temsilciyi alır veya ayarlar.

DefaultServiceNames

Kayıtlı ön ekler tarafından belirlenen Hizmet Sağlayıcısı Adlarının (SPN) varsayılan listesini alır.

ExtendedProtectionPolicy

Bir oturum için genişletilmiş koruma için kullanılacak öğesini ExtendedProtectionPolicy alır veya ayarlar.

ExtendedProtectionSelectorDelegate

Her istek için kullanılacak öğesini belirlemek için çağrılan temsilciyi ExtendedProtectionPolicy alır veya ayarlar.

IgnoreWriteExceptions

Uygulamanızın yanıtı istemciye gönderdiğinde oluşan özel durumları alıp almadığını belirten bir BooleanHttpListener değer alır veya ayarlar.

IsListening

Başlatılıp HttpListener başlatılmadığını belirten bir değer alır.

IsSupported

Geçerli işletim sistemiyle kullanılıp kullanılamayacağını HttpListener belirten bir değer alır.

Prefixes

Bu HttpListener nesne tarafından işlenen Tekdüzen Kaynak Tanımlayıcısı (URI) ön eklerini alır.

Realm

Bu HttpListener nesneyle ilişkili bölge veya kaynak bölümünü alır veya ayarlar.

TimeoutManager

Bu HttpListener örneğin zaman aşımı yöneticisi.

UnsafeConnectionNtlmAuthentication

NTLM kullanıldığında kimlik doğrulaması için aynı İletim Denetimi Protokolü (TCP) bağlantısını kullanan ek isteklerin gerekip gerekmediğini denetleyebilen bir Boolean değer alır veya ayarlar.

Yöntemler

Abort()

Şu anda kuyruğa alınan tüm istekleri atarak nesneyi hemen kapatır HttpListener .

BeginGetContext(AsyncCallback, Object)

Gelen isteği zaman uyumsuz olarak almaya başlar.

Close()

öğesini kapatır HttpListener.

EndGetContext(IAsyncResult)

Gelen istemci isteğini almak için zaman uyumsuz bir işlemi tamamlar.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetContext()

Gelen bir isteği bekler ve bir istek alındığında döndürür.

GetContextAsync()

Zaman uyumsuz işlem olarak gelen bir isteği bekler.

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)
Start()

Bu örneğin gelen istekleri almasına izin verir.

Stop()

Bu örneğin yeni gelen istekleri almayı durdurmasına neden olur ve devam eden tüm isteklerin işlenmesini sonlandırır.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

IDisposable.Dispose()

Bu HttpListener nesne tarafından tutulan kaynakları serbest bırakır.

Şunlara uygulanır

Ayrıca bkz.