# web.soapClient 库模块帮助文档

[🅰 web.soapClient 范例](https://www.aardio.com/zh-cn/docs/examples/Web/XML/web.soapClient.html) [✨ dotNet.createWebService 范例](https://www.aardio.com/zh-cn/docs/examples/Languages/dotNet/Advanced/WebService.html)

## web 成员列表 <a id="web" href="#web">&#x23;</a>

### web.soapClient <a id="web.soapClient" href="#web.soapClient">&#x23;</a>
纯 aardio 代码实现的精简版 WebService（SOAP）客户端，仅 10 KB.  
如果需要更复杂的 WebService 支持请改用 dotNet.createWebService 。

创建 SOAP 客户端。

### web.soapClient() <a id="web.soapClient" href="#web.soapClient">&#x23;</a>
[返回对象:webSoapClientObject](#webSoapClientObject)

### web.soapClient(serviceUrl,username,password,useragent,proxy,proxyBypass,flags) <a id="web.soapClient" href="#web.soapClient">&#x23;</a>
参数 @serviceUrl 必须指定有效服务网址（如果没加 `?WSDL` 后缀会自动添加）。  
可选参数 @username，@passowrd 用于指定连接用户名与密码。  
其他可选参数将作为创建 HTTP 客户端（inet.http 对象）的可选构造参数。  

成功返回 SOAP 客户端对象，失败返回 null,错误信息。

## webSoapClientObject 成员列表 <a id="webSoapClientObject" href="#webSoapClientObject">&#x23;</a>

### webSoapClientObject.* <a id="webSoapClientObject.any" href="#webSoapClientObject.any">&#x23;</a>
指定远程函数名。  
调用远程函数与调用本地函数的语法没有区别。  
调用远程函数成功返回远程函数返回的值，失败返回 null,错误信息。

### webSoapClientObject.bindService() <a id="webSoapClientObject.bindService" href="#webSoapClientObject.bindService">&#x23;</a>
绑定服务。  
参数 @1 可选指定服务名,无参数绑定默认服务。  
在创建对象时此函数会被自动调用一次并绑定默认服务

### webSoapClientObject.http <a id="webSoapClientObject.http" href="#webSoapClientObject.http">&#x23;</a>
用于发送请求的 HTTP 客户端（inet.http 对象）。  

[返回对象:inetHttpObject](https://www.aardio.com/zh-cn/docs/library-reference/inet/http.html#inetHttpObject)

### webSoapClientObject.lastResultXml <a id="webSoapClientObject.lastResultXml" href="#webSoapClientObject.lastResultXml">&#x23;</a>
调用接口最后一次返回值创建XML节点对象  

[返回对象:xnodeObject](#xnodeObject)

### webSoapClientObject.soapPortName <a id="webSoapClientObject.soapPortName" href="#webSoapClientObject.soapPortName">&#x23;</a>
当前绑定接口名

### webSoapClientObject.soapServiceName <a id="webSoapClientObject.soapServiceName" href="#webSoapClientObject.soapServiceName">&#x23;</a>
当前绑定服务名

### webSoapClientObject.soapTargetNamespace <a id="webSoapClientObject.soapTargetNamespace" href="#webSoapClientObject.soapTargetNamespace">&#x23;</a>
SOAP目标命名空间

### webSoapClientObject.soapUrl <a id="webSoapClientObject.soapUrl" href="#webSoapClientObject.soapUrl">&#x23;</a>
发送 SOAP 请求的目标URL，默认自 WSDL 中自动获取
