HttpListener.BeginGetContext メソッドとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

索引トップ用語の索引ランキング

HttpListener.BeginGetContext メソッド

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

受信要求の非同期の取得を開始します。

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

Visual Basic (宣言)

Public Function BeginGetContext ( _
    callback As AsyncCallback, _
    state As Object _
) As IAsyncResult

Visual Basic (使用法)

Dim instance As HttpListener
Dim callback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult

returnValue = instance.BeginGetContext(callback, state)

public IAsyncResult BeginGetContext (
    AsyncCallback callback,
    Object state
)

C++

public:
IAsyncResult^ BeginGetContext (
    AsyncCallback^ callback, 
    Object^ state
)

public IAsyncResult BeginGetContext (
    AsyncCallback callback, 
    Object state
)

JScript

public function BeginGetContext (
    callback : AsyncCallback, 
    state : Object
) : IAsyncResult

パラメータ

callback: クライアント要求が使用可能なときに呼び出すメソッドを参照する AsyncCallback デリゲート。

state: 操作に関する情報を格納するユーザー定義のオブジェクト。このオブジェクトは、操作の完了時に callback デリゲートに渡されます。

戻り値
非同期操作のステータスを示す IAsyncResult オブジェクト。

例外

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

解説

BeginGetContext メソッドは、非同期 (非ブロック) の呼び出しを開始して、受信クライアント要求を受信します。このメソッドを呼び出す前に、Start メソッドを呼び出し、Prefixes プロパティから返される HttpListenerPrefixCollection に URI 文字列を追加して、待機する 1 つ以上の URI (Uniform Resource Identifier) プレフィックスを追加する必要があります。

非同期の操作は、EndGetContext メソッドを呼び出して終了させる必要があります。このメソッドは、通常、callback デリゲートによって呼び出されます。

このメソッドは、操作の実行中にブロックしません。受信要求を取得し、操作が完了するまでブロックするには、GetContext メソッドを呼び出します。

非同期プログラミングモデルの使用法の詳細については、「同期メソッドの非同期呼び出し」を参照してください。

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

使用例

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

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

このページでは「.NET Framework クラスライブラリリファレンス」からHttpListener.BeginGetContext メソッドを検索した結果を表示しています。
Weblioに収録されているすべての辞書からHttpListener.BeginGetContext メソッドを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からHttpListener.BeginGetContext メソッドを検索

>> 「HttpListener.BeginGetContext メソッド」を含む用語の索引
HttpListener.BeginGetContext メソッドのページへのリンク


	© 2025 Microsoft.All rights reserved.

HttpListener.BeginGetContext メソッドとは？ わかりやすく解説

HttpListener.BeginGetContext メソッド

急上昇のことば

HttpListener.BeginGetContext メソッドとは？わかりやすく解説