Sys.Net.WebRequestManager の defaultExecutor プロパティ

更新 : 2007 年 11 月

ネットワーク要求の作成に使用される既定のネットワーク エグゼキュータの種類を取得または設定します。

メモ :
クライアント API プロパティのプロパティ値を取得または設定するには、名前のプレフィックスが get_ および set_ のプロパティ アクセサ メソッドを呼び出す必要があります。たとえば、cancel のプロパティの値を取得または設定するには、get_cancel メソッドまたは set_cancel メソッドを呼び出します。

var dExecutor = Sys.WebRequestManager.get_defaultExecutorType ();
Sys.Net.WebRequestManager.set_defaultExecutorType(value);

パラメータ

パラメータ	説明
value	WebRequestExecutor クラスの実装への参照。

例外

例外の種類	条件
Sys.ArgumentException	無効なパラメータが渡されました。

戻り値

既定の Web 要求エグゼキュータを表すオブジェクト。

解説

defaultExecutor プロパティを使用して、現在の WebRequestExecutor オブジェクトへの参照である既定のエグゼキュータを取得または設定します。

WebRequestExecutor オブジェクトは、Web 要求をエグゼキュータに送信する準備ができると、指定された要求エグゼキュータを使用します。エグゼキュータを指定しなかった場合、WebRequestExecutor は XmlHttpExecutor クラスのインスタンスを作成します。

使用例

defaultExecutorType プロパティを使用して、既定のエグゼキュータを取得および設定する方法を次の例に示します。このコードは、WebRequestManager クラスの概要で説明しているコード例の一部分です。

// Gets and sets the default executor.
function DefaultExecutor()
{
    // Clear the previous results. 
    resultElement.innerHTML = "";

    // Get system default executor type.
    var sysDefaultExecutor = 
        Sys.Net.WebRequestManager.get_defaultExecutorType();
    alert("Get default executor:" + sysDefaultExecutor);


    // Modify the default executor type.
    Sys.Net.WebRequestManager.set_defaultExecutorType(
    "Sys.Net.CustomExecutor");

    var customDefaultExecutor = 
        Sys.Net.WebRequestManager.get_defaultExecutorType();

    alert("Set default executor: " + customDefaultExecutor);

    // Set the executor back to the system default. This is 
    // to allow the WebRequest script to run.
    executor = "Sys.Net.XMLHttpExecutor";
    Sys.Net.WebRequestManager.set_defaultExecutorType(
    sysDefaultExecutor);    

}

参照

参照

Sys.Net.WebRequestManager クラス

Sys.Net.WebRequestExecutor クラス

Sys.Net.XMLHttpExecutor クラス