HttpListener.Start HttpListener.Start HttpListener.Start HttpListener.Start Method

定義

このインスタンスが受信要求を受信できるようにします。Allows this instance to receive incoming requests.

public:
 void Start();
public void Start ();
member this.Start : unit -> unit
Public Sub Start ()

例外

Win32 関数呼び出しが失敗しました。A Win32 function call failed. 例外の ErrorCode プロパティを調べて、例外の原因を確認します。Check the exception's ErrorCode property to determine the cause of the exception.

オブジェクトが閉じています。This object is closed.

次のコード例は、 Startメソッドを使用して受信要求の処理を開始する方法を示しています。The following code example demonstrates using the Start method to begin processing incoming requests.


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

注釈

メソッドまたはBeginGetContextメソッドを呼び出す前に、 GetContextこのメソッドを呼び出す必要があります。This method must be called before you call the GetContext or BeginGetContext method.

HttpListenerオブジェクトを開始した後は、 Stopメソッドを使用してオブジェクトを停止できます。After you have started an HttpListener object, you can use the Stop method to stop it.

注意

このリスナーインスタンスで https を使用する場合は、サーバー証明書をインストールして選択する必要があります。If this listener instance uses https, you must install and select a Server Certificate. そうしないHttpWebRequestと、このHttpListenerクエリは失敗し、接続が予期せず終了します。Otherwise, an HttpWebRequest query of this HttpListener will fail with an unexpected close of the connection. Httpcfg.exe を使用して、サーバー証明書とその他のリスナーオプションを構成できます。You can configure Server Certificates and other listener options by using HttpCfg.exe. 詳細http://msdn.microsoft.com/library/default.asp?url=/library/http/http/httpcfg_exe.aspについては、「」を参照してください。See http://msdn.microsoft.com/library/default.asp?url=/library/http/http/httpcfg_exe.asp for more details.

注意 (呼び出し元)

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。This member outputs trace information when you enable network tracing in your application. 詳細については、「 .NET Framework のネットワークトレース」を参照してください。For more information, see Network Tracing in the .NET Framework.

適用対象