Sys.Services の RoleService の roles プロパティ

更新 : 2007 年 11 月

現在認証されているユーザーのロールを取得します。

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

var roles = Sys.Services.RoleService.get_roles();

戻り値

このロールを格納している Array インスタンス。

解説

roles プロパティにアクセスする前に、load メソッドを使用してロールを読み込む必要があります。ロールを読み込まなかった場合、またはロールが定義されていない場合、空の array が返されます。

使用例

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

// This function gets the role service timeout.
function GetRoleServiceTimeout()
{
    // Get the role service path.
    var roleServiceTimeout = 
        Sys.Services.RoleService.get_timeout();

    DisplayInformation(
            "Role service timeout: " + roleServiceTimeout);

}

参照

概念

Sys.Services.AuthenticationService クラス

Sys.Services.ProfileService クラス