HttpListener.BeginGetContext(AsyncCallback, Object) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Net
Zestaw:
System.Net.HttpListener.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll
Źródło:
HttpListener.Managed.cs
Źródło:
HttpListener.Managed.cs
Źródło:
HttpListener.Managed.cs

Rozpoczyna asynchronicznie pobieranie żądania przychodzącego.

public:
 IAsyncResult ^ BeginGetContext(AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginGetContext (AsyncCallback? callback, object? state);
public IAsyncResult BeginGetContext (AsyncCallback callback, object state);
member this.BeginGetContext : AsyncCallback * obj -> IAsyncResult
Public Function BeginGetContext (callback As AsyncCallback, state As Object) As IAsyncResult

Parametry

callback
AsyncCallback

Delegat AsyncCallback , który odwołuje się do metody wywoływania, gdy żądanie klienta jest dostępne.

state
Object

Obiekt zdefiniowany przez użytkownika, który zawiera informacje o operacji. Ten obiekt jest przekazywany do delegata po zakończeniu callback operacji.

Zwraca

IAsyncResult

IAsyncResult Obiekt wskazujący stan operacji asynchronicznej.

Wyjątki

HttpListenerException

Wywołanie funkcji Win32 nie powiodło się. Sprawdź właściwość wyjątku ErrorCode , aby określić przyczynę wyjątku.

InvalidOperationException

Ten obiekt nie został uruchomiony lub jest obecnie zatrzymany.

ObjectDisposedException

Ten obiekt jest zamknięty.

Przykłady

Poniższy przykład kodu przedstawia użycie BeginGetContext metody w celu określenia metody wywołania zwrotnego, która będzie obsługiwać przychodzące żądania klientów.


public static void NonblockingListener(string [] prefixes)
{
    HttpListener listener = new HttpListener();
    foreach (string s in prefixes)
    {
        listener.Prefixes.Add(s);
    }
    listener.Start();
    IAsyncResult result = listener.BeginGetContext(new AsyncCallback(ListenerCallback),listener);
    // Applications can do some work here while waiting for the
    // request. If no work can be done until you have processed a request,
    // use a wait handle to prevent this thread from terminating
    // while the asynchronous operation completes.
    Console.WriteLine("Waiting for request to be processed asyncronously.");
    result.AsyncWaitHandle.WaitOne();
    Console.WriteLine("Request processed asyncronously.");
    listener.Close();
}

Public Shared Sub NonblockingListener(ByVal prefixes As String())
    Dim listener As HttpListener = New HttpListener()

    For Each s As String In prefixes
        listener.Prefixes.Add(s)
    Next

    listener.Start()
    Dim result As IAsyncResult = listener.BeginGetContext(New AsyncCallback(AddressOf ListenerCallback), listener)
    ' Applications can do some work here while waiting for the 
    ' request. If no work can be done until you have processed a request,
    ' use a wait handle to prevent this thread from terminating
    ' while the asynchronous operation completes.
    Console.WriteLine("Waiting for request to be processed asyncronously.")
    result.AsyncWaitHandle.WaitOne()
    Console.WriteLine("Request processed asyncronously.")
    listener.Close()
End Sub

Poniższy przykład kodu implementuje metodę wywołania zwrotnego.

public static void ListenerCallback(IAsyncResult result)
{
    HttpListener listener = (HttpListener) result.AsyncState;
    // Call EndGetContext to complete the asynchronous operation.
    HttpListenerContext context = listener.EndGetContext(result);
    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();
}

Public Shared Sub ListenerCallback(ByVal result As IAsyncResult)
    Dim listener As HttpListener = CType(result.AsyncState, HttpListener)
    ' Call EndGetContext to complete the asynchronous operation.
    Dim context As HttpListenerContext = listener.EndGetContext(result)
    Dim request As HttpListenerRequest = context.Request
    ' Obtain a response object.
    Dim response As HttpListenerResponse = context.Response
    ' Construct a 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()
End Sub

Uwagi

Metoda BeginGetContext rozpoczyna asynchroniczne (nieblokacyjne) wywołanie w celu odbierania przychodzących żądań klientów. Przed wywołaniem tej metody należy wywołać metodę Start i dodać co najmniej jeden prefiks identyfikatora URI do nasłuchiwania przez dodanie ciągów identyfikatora URI do HttpListenerPrefixCollection zwracanej przez Prefixes właściwość .

Operacja asynchroniczna musi zostać ukończona przez wywołanie EndGetContext metody . Zazwyczaj metoda jest wywoływana przez delegata callback .

Ta metoda nie blokuje się po zakończeniu operacji. Aby pobrać żądanie przychodzące i zablokować je do momentu zakończenia operacji, wywołaj metodę GetContext .

Aby uzyskać szczegółowe informacje na temat korzystania z modelu programowania asynchronicznego, zobacz Asynchroniczne wywoływanie metod synchronicznych.

Uwagi dotyczące wywoływania

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Dotyczy