更新：2007 年 11 月
调用相应的 Web 服务方法。在运行时，当服务器已生成代理类之后，将存在这些方法。
.gif "说明") 说明： |
|---|
生成的代理类方法的名称基于相关 Web 服务方法中的方法。 |
// Call a Web service method using the proxy class.
MyNameSpace.MyServiceProxy.MyServiceMethod(param1, param2, SucceededCallback, FailedCallback, userContext);
// Call a Web service method using a proxy class instance.
var myServiceProxy = MyNameSpace.MyService();
myServiceProxy.MyServiceMethod(param1, param2, SucceededCallback, FailedCallback, userContext);
参数
参数 |
定义 |
|---|---|
param1, param2, paramn |
Web 服务方法的参数。可以传递的参数的个数与 Web 服务方法中定义的参数个数相同。 |
SucceededCallback |
成功回调函数。这是一个可选参数。如果未传递任何值，那么：如果定义了 defaultSucceededCallback 值，则会使用该值；否则，调用将在不提示的情况下成功，并且客户端不会对结果进行任何处理。如果向该方法调用中的后续参数传递值，则必须将 SucceededCallback 设置为 null。 |
FailedCallback |
失败回调函数。这是一个可选参数。如果未传递任何值，那么：如果定义了 defaultFailedCallback 值，则会使用该值；否则，Web 服务调用将在不提示的情况下失败。如果向该方法调用中的后续参数传递值，则必须将 FailedCallback 设置为 null。 |
userContext |
一个包含用户上下文的对象。这是一个可选参数。如果未传递任何值，那么：如果定义了 defaultUserContext 值，则会使用该值；否则会将 null 传递给回调函数。 |
备注
可以使用生成的代理类来调用 Web 服务方法。另外，您还可以创建 Web 服务代理类的实例。然后，可以指定成功回调函数、失败回调函数以及（可选）超时值或用户上下文作为该实例的属性。接着可以使用此代理实例来调用 Web 服务方法。在这种情况下，不必在调用中传递回调函数或用户上下文。如果确实传递了这些值，它们将重写被设置为实例属性的任何默认值。
可以创建多个代理类实例，并且使每个实例都具有不同的属性。通常，当您希望向不同的 Web 服务调用应用不同的默认值（例如不同的回调函数）时，需要创建生成的代理类的实例。通过使用不同的回调函数，可以根据应用程序的需要，按照不同的方式处理返回的数据。调用代理实例的方法还可简化调用 Web 服务方法的语法和回调函数的逻辑。
示例
下面的示例演示如何定义代理类实例的默认值并且随后使用该实例调用 Web 服务方法。
proxyInstance =
new Samples.AspNet.UsingProxyClass();
proxyInstance.set_timeout(1000);
proxyInstance.set_defaultUserContext("New context");
proxyInstance.set_defaultSucceededCallback(SucceededCallback);
proxyInstance.set_defaultFailedCallback(FailedCallback);
// Set the default color object.
proxyInstance.SetColor(color);
请参见
概念
参考
生成的代理类 defaultFailedCallback 属性