Sys.Services の RoleService の load メソッド

更新 : 2007 年 11 月

現在認証されているユーザーのロールをローカル クライアント メモリに読み込みます。

Sys.Services.RoleService.load(loadCompletedCallback, failedCallback, userContext);

パラメータ

パラメータ	説明
loadCompletedCallback	読み込み処理が完了すると呼び出される関数。既定値は null です。
failedCallback	読み込みが失敗すると呼び出される関数。既定値は null です。
userContext	コールバック関数に渡されるユーザー コンテキスト情報。

解説

ロールは、RoleService プロキシ クラスによってクライアントのメモリに格納され、アクセスには roles プロパティを使用します。呼び出しが正常終了した場合は、[P:J#Sys.Services.RoleService.defaultLoadCompletedCallback] プロパティに指定された関数が呼び出され、ロールのリストが返されます。呼び出しが正常終了し、defaultLoadCompletedCallback プロパティが null だった場合は、SucceededCallback 関数が呼び出されます。

ロール サービスの呼び出しが失敗した場合は、defaultFailedCallback プロパティに指定された関数が呼び出されます。

使用例

現在認証されているユーザーのロールを読み込む方法を次の例に示します。このコードは、RoleService クラスの概要で説明しているコード例の一部です。

// This function sets and gets the role service
// default failed callback function.
function DefaultFailedCallBack()
{
     // Set default failed callback function.
    roleProxy.set_defaultFailedCallback(FailedCallback);

    // Get the default callback function. 
    var failedCallBack =     
        roleProxy.get_defaultFailedCallback();

    alert(failedCallBack); 
}

参照

概念

Sys.Services.AuthenticationService クラス

Sys.Services.ProfileService クラス