Sys.Net.WebRequestManager の add_invokingRequest メソッド
更新 : 2007 年 11 月
WebRequestManager の呼び出し要求イベントを処理するハンドラを登録します。
Sys.Net.WebRequestManager.add_invokingRequest(handler);
パラメータ
パラメータ |
説明 |
---|---|
handler |
呼び出し要求イベントを処理するために登録する関数。 |
解説
add_invokingRequest メソッドは、WebRequestManager クラスが Web 要求をエグゼキュータにルーティングする前に呼び出す必要がある関数を設定するために使用します。このイベントを使用すると、WebRequestManager に対する Web 要求を調べることができます。このイベントは、次のタスクの実行に使用できます。
実行中のネットワーク要求を監査します。
Web 要求を受け取り、選択的にキャンセルします。
エグゼキュータ構造ではなくカスタム ロジックを使用して、Web 要求を処理します。たとえば、要求をネットワーク上に流すのではなく、要求を受け取るごとにローカル ストアを基に応答データを作成するように、ローカル ストレージ サービスを設定できます。
イベント ハンドラは、次のシグネチャを持つ必要があります。
function OnInvokingRequest(sender, networkRequestEventArgs){}
sender パラメータは WebRequestManager インスタンスに設定されます。
使用例
Web 要求が実行される前に、発行されるイベントを追加する方法を、次の例に示します。このコードは、WebRequestManager クラスの概要で説明しているコード例の一部分です。
// Set the handler to call before the Web request
// is executed.
Sys.Net.WebRequestManager.add_invokingRequest(On_InvokingRequest);