Sys.Services RoleService defaultFailedCallback 属性

更新:2007 年 11 月

获取或设置默认失败回调函数的名称。

说明:

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

var defaultFailedCallback =
  Sys.Services.RoleService.get_defaultFailedCallback();
Sys.Services.RoleService.set_defaultFailedCallback(value); 

参数

参数

说明

value

默认失败回调函数的名称。

备注

此属性中指定的函数用作角色服务失败时的默认回调函数。通过将另一个函数的名称传递给 load 方法,可以重写此默认回调函数。

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

function callbackFunctionName(error, userContext, methodName)

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

  • error. 包含 WebServiceError 类的一个实例。

  • userContext. 传递给 load 方法的用户上下文信息(如果有)。

  • methodName. 调用方法的名称。

如果角色服务失败,则对回调函数进行异步调用。

示例

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

// This function sets and gets the role service
// default load completed callback function.
function DefaultLoadCompletedCallBack()
{
    // Set the default callback function.
    roleProxy.set_defaultLoadCompletedCallback(LoadCompletedCallback);

    // Get the default callback function. 
    var loadCompletedCallBack =     
        roleProxy.get_defaultLoadCompletedCallback();

    alert(loadCompletedCallBack);
}

请参见

概念

Sys.Services.AuthenticationService 类

Sys.Services.ProfileService 类