HttpListener.BeginGetContext(AsyncCallback, Object) Método

  • Referencia

Definición

Espacio de nombres:
System.Net
Ensamblado:
System.Net.HttpListener.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.dll
Source:
HttpListener.Managed.cs
Source:
HttpListener.Managed.cs
Source:
HttpListener.Managed.cs

Empieza a recuperar de forma asincrónica una solicitud de entrada.

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

Parámetros

callback
AsyncCallback

Un delegado de AsyncCallback que hace referencia al método que se invoca cuando está disponible una solicitud de cliente.

state
Object

Objeto definido por el usuario que contiene información sobre la operación. Este objeto se pasa al delegado de callback cuando la operación ha terminado.

Devoluciones

IAsyncResult

Un objeto IAsyncResult que indica el estado de la operación asincrónica.

Excepciones

HttpListenerException

Se ha producido un error en una llamada de función de Win32. Examine la propiedad ErrorCode de la excepción para determinar su causa.

InvalidOperationException

Este objeto no se ha iniciado o actualmente está detenido.

ObjectDisposedException

Este objeto está cerrado.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el BeginGetContext método para especificar un método de devolución de llamada que controlará las solicitudes de cliente entrantes.


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

En el ejemplo de código siguiente se implementa un método de devolución de llamada.

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

Comentarios

El BeginGetContext método inicia una llamada asincrónica (sin bloqueo) para recibir solicitudes de cliente entrantes. Antes de llamar a este método, debe llamar al Start método y agregar al menos un prefijo de identificador uniforme de recursos (URI) para escuchar agregando las cadenas de URI al HttpListenerPrefixCollection devuelto por la Prefixes propiedad .

La operación asincrónica debe completarse llamando al EndGetContext método . Normalmente, el delegado invoca el callback método .

Este método no se bloquea mientras se completa la operación. Para obtener una solicitud entrante y bloquear hasta que se complete la operación, llame al GetContext método .

Para obtener información detallada sobre el uso del modelo de programación asincrónica, vea Llamar a métodos sincrónicos de forma asincrónica.

Notas a los autores de las llamadas

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, vea Seguimiento de red en .NET Framework.

Se aplica a