HttpListener.BeginGetContext(AsyncCallback, Object) Метод

Ссылка

Определение

Пространство имен:: System.Net

Сборка:: System.Net.HttpListener.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Исходный код:: HttpListener.Managed.cs

Исходный код:: HttpListener.Managed.cs

Исходный код:: HttpListener.Managed.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Начинает асинхронное получение входящего запроса.

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

Параметры

callback: AsyncCallback

Делегат AsyncCallback, ссылающийся на метод, который следует вызвать при наличии клиентского запроса.

state: Object

Пользовательский объект, содержащий сведения об операции. Этот объект передается делегату callback после завершения операции.

Возвращаемое значение

IAsyncResult

Объект IAsyncResult, представляющий состояние асинхронной операции.

Исключения

HttpListenerException

Вызов функции Win32 завершился с ошибкой. Проверьте свойство исключения ErrorCode, чтобы определить причину исключения.

InvalidOperationException

Этот объект не был запущен или в настоящее время остановлен.

ObjectDisposedException

Данный объект закрыт.

Примеры

В следующем примере кода показано использование BeginGetContext метода для указания метода обратного вызова, который будет обрабатывать входящие клиентские запросы.


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

В следующем примере кода реализуется метод обратного вызова.

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

Метод BeginGetContext начинает асинхронный (неблокирующий) вызов для получения входящих клиентских запросов. Перед вызовом этого метода необходимо вызвать Start метод и добавить по крайней мере один префикс универсального кода ресурса (URI) для прослушивания, добавив строки URI в объект , HttpListenerPrefixCollection возвращаемый свойством Prefixes .

Асинхронная операция должна быть завершена путем вызова EndGetContext метода . Как правило, метод вызывается делегатом callback .

Этот метод не блокируется во время завершения операции. Чтобы получить входящий запрос и заблокировать до завершения операции, вызовите GetContext метод .

Подробные сведения об использовании асинхронной модели программирования см. в разделе Асинхронный вызов синхронных методов.

Примечания для тех, кто вызывает этот метод

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в .NET Framework.

Применяется к

Поделиться через