生成的代理类失败回调函数

更新:2007 年 11 月

在 Web 服务方法调用失败后调用来处理错误信息。

说明:

失败回调函数可以具有任何名称。

FailedCallback(error, userContext, methodName)
{
    // Code here to handle the failure.
}

参数

参数

定义

error

一个 WebServiceError 对象

userContext

在调用 Web 服务方法时传递的上下文信息。如果未传递上下文信息,则使用 defaultUserContext 值(如果已定义);否则将 null 传递给回调函数。userContext 参数提供在处理返回数据时要使用的附加信息。

methodName

调用的 Web 服务方法。methodName 参数提供在处理返回数据时要使用的附加信息。例如,使用 methodName 可以确定哪个方法调用失败。

备注

失败回调函数为 JavaScript 函数,可以用于在 Web 服务请求失败后处理错误。失败的原因可能是运行时错误或超时,也可能是 Web 服务过早地结束请求。

可以使用 defaultFailedCallback 属性将回调函数分配给生成的代理类或其实例。或者,可以在调用 Web 服务方法时传递对回调函数的引用。这会重写默认值。

示例

下面的示例演示如何定义失败回调函数。

// Callback function invoked when a call to 
// the Web service methods fails.
function FailedCallback(error, userContext, methodName) 
{
    if(error !== null) 
    {
        displayResult.innerHTML = "An error occurred: " + 
            error.get_message();
    }
}

请参见

概念

Sys.Net.WebServiceProxy 类

参考

defaultUserContext

生成的代理类 defaultFailedCallback 属性

defaultSucceededCallback