HttpListener.Start メソッド

定義

このインスタンスが受信要求を受信できるようにします。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

注釈

GetContext または BeginGetContext メソッドを呼び出す前に、このメソッドを呼び出す必要があります。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. それ以外の場合、この HttpListenerHttpWebRequest クエリは、接続が予期せず終了して失敗します。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. 詳細については、「 https://msdn.microsoft.com/library/default.asp?url=/library/http/http/httpcfg_exe.asp 」を参照してください。See https://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.

適用対象