HttpListener.BeginGetContext(AsyncCallback, Object) Metoda

  • Reference

Definice

Obor názvů:
System.Net
Sestavení:
System.Net.HttpListener.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll
Zdroj:
HttpListener.Managed.cs
Zdroj:
HttpListener.Managed.cs
Zdroj:
HttpListener.Managed.cs

Začne asynchronně načítat příchozí požadavek.

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

Delegát AsyncCallback , který odkazuje na metodu vyvolání, když je k dispozici požadavek klienta.

state
Object

Uživatelem definovaný objekt, který obsahuje informace o operaci. Tento objekt se po dokončení operace předá callback delegátu.

Návraty

IAsyncResult

Objekt IAsyncResult , který označuje stav asynchronní operace.

Výjimky

HttpListenerException

Volání funkce Win32 se nezdařilo. Zkontrolujte vlastnost výjimky ErrorCode a určete příčinu výjimky.

InvalidOperationException

Tento objekt nebyl spuštěn nebo je nyní zastaven.

ObjectDisposedException

Tento objekt je zavřený.

Příklady

Následující příklad kódu ukazuje použití BeginGetContext metody k určení metody zpětného volání, která bude zpracovávat příchozí požadavky klienta.


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

Následující příklad kódu implementuje metodu zpětného volání.

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

Poznámky

Metoda BeginGetContext zahájí asynchronní (neblokující) volání pro příjem příchozích požadavků klientů. Před voláním této metody je nutné volat metodu Start a přidat alespoň jednu předponu URI (Uniform Resource Identifier) pro naslouchání přidáním řetězců identifikátoru URI do HttpListenerPrefixCollection vrácené Prefixes vlastností.

Asynchronní operace musí být dokončena voláním EndGetContext metody . Obvykle je metoda vyvolána delegátem callback .

Tato metoda neblokuje po dokončení operace. Pokud chcete získat příchozí požadavek a blokovat ho, dokud se operace nedokoní, zavolejte metodu GetContext .

Podrobné informace o použití asynchronního programovacího modelu najdete v tématu Asynchronní volání synchronních metod.

Poznámky pro volající

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Platí pro