HttpListener Sınıf

Başvuru

Tanım

Ad Alanı:: System.Net

Bütünleştirilmiş Kod:: System.Net.HttpListener.dll

Bütünleştirilmiş Kod:: System.dll

Bütünleştirilmiş Kod:: netstandard.dll

Kaynak:: HttpListener.cs

Kaynak:: HttpListener.cs

Kaynak:: HttpListener.cs

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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: Object
HttpListener

Uygulamalar: IDisposable

Ö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 Boolean HttpListener 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

Aracılığıyla paylaş