Sys.Services の AuthenticationService の defaultFailedCallback プロパティ

更新 : 2007 年 11 月

既定の失敗コールバック関数の名前を取得または設定します。

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

Sys.Services.AuthenticationService.set_defaultFailedCallback(value); 
var failedCallback =
    Sys.Services.AuthenticationService.get_ defaultFailedCallback();

パラメータ

パラメータ	説明
value	既定の失敗コールバック関数の名前を含む文字列。

解説

defaultFailedCallback プロパティに割り当てた関数は、エラーが発生した場合の既定のコールバック関数として使用されます。この既定のコールバック関数をオーバーライドするには、別の関数の名前を logout メソッドまたは login メソッドに渡します。

このコールバック関数を実装するには、次のシグネチャを使用する必要があります。

function AuthenticationFailure(error, userContext, methodName)

コールバック関数に渡されるパラメータは次のとおりです。

• error。エラー情報を格納します。

• userContext。logout メソッドまたは login メソッドに渡すユーザー コンテキスト情報です。

• methodName。呼び出し元メソッドの名前です。

認証サービスが失敗すると、コールバック関数が非同期に呼び出されます。

使用例

defaultFailedCallback プロパティを使用する方法の例を次に示します。このコードは、Sys.Services.AuthenticationService クラス クラスの概要で説明しているコード例の一部です。

// This function sets and gets the default
// failed callback function.
function SetDefaultFailedCallBack()
{
    // Set the default callback function.
    Sys.Services.AuthenticationService.set_defaultFailedCallback(OnFailed);

    // Get the default callback function.
    var callBack =     
        Sys.Services.AuthenticationService.get_defaultFailedCallback();  
}

参照

概念

Sys.Services.ProfileService クラス

Sys.Net.WebServiceProxy クラス