HttpListener.Start Метод

Определение

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

System.Net

Сборка:

System.Net.HttpListener.dll

Исходный код:

HttpListener.Managed.cs

Позволяет этому экземпляру получать входящие запросы.

public:
 void Start();

public void Start ();

member this.Start : unit -> unit

Public Sub Start ()

Исключения

HttpListenerException

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

ObjectDisposedException

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

Примеры

В следующем примере кода демонстрируется использование метода для Start начала обработки входящих запросов.

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

Комментарии

Этот метод необходимо вызвать перед вызовом GetContext метода или BeginGetContext .

После запуска HttpListener объекта можно использовать метод , Stop чтобы остановить его.

Примечание

Если этот экземпляр прослушивателя использует https, необходимо установить и выбрать сертификат сервера. В противном HttpWebRequest случае запрос HttpListener завершится ошибкой при неожиданном закрытии соединения. Сертификаты сервера и другие параметры прослушивателя можно настроить с помощью HttpCfg.exe.

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

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