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

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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, která se má vyvolat, když je k dispozici požadavek klienta.

state: Object

Objekt definovaný uživatelem, 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 právě 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 identifikátoru URI (Uniform Resource Identifier), která bude naslouchat 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 během dokončení operace. Pokud chcete získat příchozí požadavek a blokovat ji, 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 najdete v tématu Trasování sítě v rozhraní .NET Framework.

Platí pro

Sdílet prostřednictvím