DataSource 类

定义

命名空间:

Microsoft.Office.InfoPath

程序集:

Microsoft.Office.InfoPath.dll

代表表单模板中的数据源。

public ref class DataSource abstract

public abstract class DataSource

type DataSource = class

Public MustInherit Class DataSource

继承

Object

DataSource

注解

对象 DataSource 对应于与 InfoPath 表单模板关联的存储数据的源之一。 对象DataSource可以表示表单模板的主 (main) 数据源，也可以表示使用 Microsoft InfoPath) 第一版中称为数据适配器的关联数据连接从某些外部数据源获取的辅助数据源 (。 通过使用表单的主要数据源，可以访问表单的基础 XML 文档，而使用辅助数据源则可访问从诸如 Web 服务查询等外部数据源中检索的数据。

对象 DataSource 提供可用于以编程方式与存储数据交互的属性和方法，并提供对辅助数据源的关联数据连接的访问权限。 DataSource可以使用 类的 XmlForm 属性访问 DataSources 对象。

对于辅助数据源，DataSource对象充当表单和数据连接之间的中介，该连接用于从外部数据源获取数据，例如连接到 Microsoft Access 或 Microsoft SQL Server 数据库、.xml 文件或 XML Web 服务。 使用的数据连接对象的类型取决于获取数据的外部数据连接的类型。 对象 DataSource 提供一组通用的属性和方法，这些属性和方法可用于所有类型的数据连接对象，每个数据连接对象提供其自己的属性和方法集。

Microsoft InfoPath 支持以下类型的数据连接：

• 使用 ActiveX 数据对象 (ADO 的连接查询或提交) 由 AdoQueryConnection 和 AdoSubmitConnection 对象表示。
• 用于查询或提交到业务数据连接服务中注册的外部数据源的连接 (BDC) 运行由 或 BdcSubmitConnection 对象表示BdcQueryConnection的 SharePoint Foundation 2010 或 SharePoint Server 2010 的服务器。
• 用于查询或提交到 由 Microsoft.Office.InfoPath.SharepointListRWQueryConnection 或 Microsoft.Office.InfoPath.SharepointListRWSubmitConnection 对象表示的 SharePoint 列表的连接。
• 与由 对象表示的 WebServiceConnection Web 服务的连接。
• 用于查询或提交到 由 FileQueryConnection 和 FileSubmitConnection 对象表示的 XML 文件的连接。
• 要通过由 对象表示 EmailSubmitConnection 的电子邮件提交的连接。

类 DataSource 对应于 Microsoft InfoPath 2003 对象模型中的 DataObject 接口。

构造函数

DataSource()

代表表单模板中的数据源。

属性

Name	获取关联 DataSource 对象的名称。
QueryConnection	获取对 DataConnection 与数据源关联的 对象的引用。
ReadOnly	获取一个值，指明数据源是否处于只读状态。

方法

CreateNavigator()	返回 XPathNavigator
GetNamedNodeProperty(XPathNavigator, String)	获取指定 XML 节点的命名属性的值，该节点必须是主数据源中的 nonattribute 节点。
SetNamedNodeProperty(XPathNavigator, String, String)	设置指定 XML 节点的命名属性的值，该节点必须是主数据源中的 nonattribute 节点。