HttpListener.Start メソッド

.NET Framework クラス ライブラリ リファレンス

HttpListener.Start メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

このインスタンスが受信要求を受信できるようにします。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub Start

Visual Basic (使用法)

Dim instance As HttpListener

instance.Start

C#

public void Start ()

C++

public:
void Start ()

J#

public void Start ()

JScript

public function Start ()

例外

例外の種類	条件
HttpListenerException	Win32 関数呼び出しが失敗しました。例外の ErrorCode プロパティをチェックして、例外の原因を確認してください。
ObjectDisposedException	オブジェクトが閉じています。

解説

このメソッドは、GetContext メソッドまたは BeginGetContext メソッドを呼び出す前に呼び出す必要があります。

HttpListener オブジェクトを開始したら、Stop メソッドを使用して停止できます。

メモ
このリスナ インスタンスが https を使用する場合、Server Certificate をインストールして選択する必要があります。そうしないと、この HttpListener の HttpWebRequest クエリは、予期しない接続の終了で失敗します。Server Certificates および他のリスナ オプションは、HttpCfg.exe を使用して構成できます。詳細については、http://msdn.microsoft.com/library/default.asp?url=/library/en-us/http/http/httpcfg_exe.asp を参照してください。

呼び出し時の注意 このメンバは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。詳細については、「ネットワークのトレース」を参照してください。

使用例

Start メソッドを使用して受信要求の処理を開始するコード例を次に示します。

C#

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();
}

プラットフォーム

Windows 98, Windows Server 2003, Windows XP Media Center Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HttpListener クラス
HttpListener メンバ
System.Net 名前空間