WebServiceConnection 类

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

继承层次结构

System.Object
  Microsoft.Office.InfoPath.DataConnection
    Microsoft.Office.InfoPath.WebServiceConnection

命名空间:  Microsoft.Office.InfoPath
程序集:  Microsoft.Office.InfoPath(位于 Microsoft.Office.InfoPath.dll 中)

语法

声明
Public MustInherit Class WebServiceConnection _
    Inherits DataConnection
用法
Dim instance As WebServiceConnection
public abstract class WebServiceConnection : DataConnection

备注

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

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

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

除了从 DataConnection 基类中继承的默认 Execute 方法(该方法使用在 InfoPath 表单模板设计模式下以声明方式定义的值执行查询或提交操作)外,WebServiceConnection 类还提供 WebServiceConnection.Execute 方法,利用该方法可以指定要提交的另一个数据源、要插入所返回数据的另一个位置,以及检索连接所返回错误的方式。

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

示例

在以下示例中,将通过以下方式设置对 WebServiceConnection 对象(代表名为"Main query"的连接)的引用:将名称传递到 DataConnectionCollection 类的 Item 属性,然后将返回的对象转换为 WebServiceConnection 类型。

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()

线程安全性

该类型的任何公共 静态 (已共享 在 Visual Basic 中) 成员都是线程安全的。不保证任何实例成员都是线程安全的。

另请参阅

引用

WebServiceConnection 成员

Microsoft.Office.InfoPath 命名空间