Sys.Services RoleService defaultLoadCompletedCallback 属性

更新：2007 年 11 月

获取或设置默认加载完成回调函数的名称。

说明：
若要获取或设置客户端 API 属性的属性值，必须调用以 get_ 和 set_ 为名称前缀的属性访问器方法。例如，若要获取或设置属性 cancel 的值，需要调用 get_cancel 或 set_cancel 方法。

var defaultLoadCompletedCallback =
        Sys.Services.RoleService.get_defaultLoadCompletedCallback();
Sys.Services.RoleService.set_defaultLoadCompletedCallback(value); 

参数

备注

此属性中指定的函数用作已成功加载角色时的默认回调函数。可以通过将其他函数的名称传递给 Sys.Services RoleService.load 方法来重写此默认回调函数。

在实现此回调函数时，必须使用下面的签名：

function functionName(result, userContext, methodName)

传递给此回调函数的参数具有以下含义：

• result. 当前经过身份验证的用户的角色。

• userContext. 传递给 load 方法的用户上下文信息。

• methodName. 调用方法。此参数始终设置为 load。

如果角色服务成功完成，则对回调函数进行异步调用。

示例

下面的示例演示如何使用 defaultLoadCompletedCallback 属性。此代码摘自 RoleService 类概述中的一个完整示例。

// This function checks if the currently
// authenticated user belongs to the
// passed role. 
function UserIsInRole(role) 
{
    DisplayInformation("");
    var isUserInRole = roleProxy.isUserInRole(role);
    DisplayInformation("The user is in the " + role + 
        " role: " + isUserInRole);   
}

请参见

概念

Sys.Services.AuthenticationService 类

Sys.Services.ProfileService 类