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

更新 : 2007 年 11 月

ロール サービス パスを取得または設定します。

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

var profPath = Sys.Services.RoleService.get_path();
Sys.Services.RoleService.set_path(value); 

パラメータ

パラメータ	説明
value	ロール サービス パスを含む文字列。

解説

path プロパティは、既定では空の文字列に設定されます。path プロパティを設定しなかった場合は、組み込みのロール アプリケーション サービスを指す内部既定 ASP.NET パスが使用されます。

メモ :
組み込みのロール アプリケーション サービスを ASP.NET Web サイトの別の場所に移動することはできません。ただし、既定のロール サービスと同じメソッドとプロパティを公開するカスタムの Web サービスを指すようにすることは可能です。

通常、path プロパティは宣言マークアップで設定します。この値の指定には、絶対パス、相対パス、完全修飾ドメイン名とパスのいずれかを使用できます。path プロパティを宣言によって設定する方法を次の例に示します。

<asp:ScriptManager>
  <RoleService 
    Path = "~/Myapp/MyRoleService.asmx"/>
</asp:ScriptManager>

使用例

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

// This function gets the roles of the
// currently authenticated user. 
function ReadUserRoles() 
{
    // Clear the feedback output.
    DisplayInformation("");

    // You must load the user's roles 
    // first before you can use them.
    roleProxy.load();

    // Read the user's roles. 
    roles = roleProxy.get_roles();

}

参照

概念

Sys.Services.AuthenticationService クラス

Sys.Services.ProfileService クラス