WebServiceConnection 类

定义

命名空间:

Microsoft.Office.InfoPath

程序集:

Microsoft.Office.InfoPath.dll

代表一个与 XML Web 服务的连接。

public ref class WebServiceConnection abstract : Microsoft::Office::InfoPath::DataConnection

public abstract class WebServiceConnection : Microsoft.Office.InfoPath.DataConnection

type WebServiceConnection = class
    inherit DataConnection

Public MustInherit Class WebServiceConnection
Inherits DataConnection

继承

Object

DataConnection

WebServiceConnection

示例

在以下示例中，通过将名称传递给 Item[String]DataConnectionCollection 类的 属性，然后将返回的对象转换为 WebServiceConnection 类型来设置对 WebServiceConnection 对象的引用，该对象代表名为“Main query”的连接。

WebServiceConnection wsConnection = (WebServiceConnection)this.DataConnections["Main query"];

Dim wsConnection As WebServiceConnection = _
   DirectCast(Me.DataConnections("Main query"), WebServiceConnection)

设置引用后，可以使用 WebServiceConnection 对象的属性，如以下示例所示，该示例将字符串变量设置为 属性 ServiceUrl 返回的值。

string wsServiceURL = wsConnection.ServiceUrl.ToString();

Dim wsServiceURL As String = _
   string wsServiceURL = wsConnection.ServiceUrl.ToString()

注解

WebServiceConnection 类表示使用数据连接向导在 InfoPath 中创建的数据连接，该向导指定使用 Web 服务从外部数据源检索数据并将数据提交到外部数据源所需的所有信息。

WebServiceConnection 提供多种属性，可用来获取和设置有关数据连接的输入和操作字符串的信息。 它还提供另外一个属性，用来获取 XML Web 服务的 Web Services 描述语言 (WSDL) 文件的统一资源定位器 (URL)。

可以使用 DataConnections 类的 XmlForm 属性访问与数据连接关联的 WebServiceConnection 对象，以便从DataConnectionCollection表单模板的 返回连接。

除了从基类继承DataConnection的默认Execute()方法（该基类使用在 InfoPath 表单模板设计模式下以声明方式定义的值执行查询或提交操作）外，WebServiceConnection 类还提供 Execute(XPathNavigator, XPathNavigator, XPathNavigator) 方法，该方法允许指定要提交的不同数据源，以及用于插入返回数据的不同位置， 以及检索连接返回的错误的方法。

WebServiceConnection 类对应于 Microsoft Office InfoPath 2003 对象模型的 WebServiceAdapterObject 接口。

构造函数

WebServiceConnection()

代表一个与 XML Web 服务的连接。

属性

Name	获取数据连接的名称。 (继承自 DataConnection)
ServiceUrl	获取或设置统一资源定位符 (URL) ，用于调用与 WebServiceConnection 对象关联的 Web 服务。
SoapAction	获取或设置与 WebServiceConnection 对象关联的 Web 服务的 soapAction 属性的值。
Timeout	获取或设置与 WebServiceConnection 对象关联的数据连接的超时值（以秒为单位）。
WsdlUrl	获取与 对象关联的 WebServiceConnection Web 服务 (WSDL) 文件的统一资源定位符 (URL) 。

方法

Execute()	根据从中调用数据连接的 ConnectionTypeConnection 类，使用以声明形式为已提交数据、查询参数或要检索的数据定义的值，在数据连接上执行提交或查询操作。 (继承自 DataConnection)
Execute(XPathNavigator, XPathNavigator, XPathNavigator)	重写从DataConnection基类继承的默认Execute()方法，以允许指定要提交的不同数据源、要插入返回的数据的不同位置或插入返回的任何错误文本的位置。
GenerateDataSetDiffGram()	适用于使用 ADO .NET DataSet 并返回 DiffGram（标识数据元素的原始版本和当前版本之间的任何差异）的数据连接。