SharePointListRWQueryConnection 类

定义

命名空间:

Microsoft.Office.InfoPath

程序集:

Microsoft.Office.InfoPath.dll

代表用于从 SharePoint 列表或文档库检索数据的数据连接。

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

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

type SharePointListRWQueryConnection = class
    inherit DataConnection

Public MustInherit Class SharePointListRWQueryConnection
Inherits DataConnection

继承

Object

DataConnection

SharePointListRWQueryConnection

示例

在以下代码示例中，通过使用下面两步操作过程来访问名为“Contacts”的数据连接（连接到 SharePoint 网站上的联系人信息列表）。 名称“Contacts”传递给 Item[String] 类的 DataConnectionCollection 属性，以检索表示数据连接的 对象。 然后，从集合返回的对象转换为 SharePointListRWQueryConnection 类型。

SharePointListRWQueryConnection spConnection = (SharePointListRWQueryConnection)this.DataConnections["Contacts"];

Dim spConnection As SharePointListRWQueryConnection = _
   DirectCast(Me.DataConnections("Contacts"), _
   SharePointListRWQueryConnection)

设置对数据连接的引用后，可以使用 对象的属性或方法 SharePointListRWQueryConnection 。 下面的代码示例将字符串变量设置为从DataConnection基类继承的属性返回Name的值。

string spName = spConnection.Name; Dim spName As String = spConnection.Name

注解

类 SharePointListRWQueryConnection 表示在 InfoPath 中创建的辅助数据连接，该连接指定从 SharePoint 列表或文档库检索数据所需的所有信息。 若要创建包含 SharePoint 列表或文档库的辅助数据连接的表单模板，请使用“数据”选项卡上的“数据连接”命令。

注意：使用 类成员SharePointListRWQueryConnection编写的代码与在 InfoPath 2003 或 InfoPath 2007 中创建的 SharePoint 列表或文档库的数据连接、与 InfoPath 2007 表单模板之一在 InfoPath 中创建的新表单模板中的数据连接，或者与使用“数据Connections”对话框中的“转换为以前版本”按钮转换的数据连接不兼容。 如果不需要保持与早期版本的 InfoPath 的兼容性，并且想要使用类的成员SharePointListRWQueryConnection编写代码，请使用“数据Connections”对话框中的“转换为当前版本”按钮转换数据连接。

注意：您可以使用 SharePoint 列表模板创建新的表单模板，从而创建与 SharePoint 列表的主要 (main) 数据连接。 但是，无法为此类表单编写后台的表单代码，原因是，用“SharePoint 列表”模板创建的表单模板仅支持声明性逻辑（例如规则）。 因此，不能使用 SharePointListRWQueryConnection 类及其成员来处理与 SharePoint 列表的主要数据连接。

类 SharePointListRWQueryConnection 提供的属性可用于获取数据连接的名称，以及连接从中检索数据的 SharePoint Foundation 或 Microsoft SharePoint Server 网站上的列表或文档库的 URL。

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

默认 Execute() 方法继承自 DataConnection 基类，使用设计时在 InfoPath 表单模板中以声明方式定义的值执行查询或提交操作。 此外， SharePointListRWQueryConnection 类提供 Execute(XPathNavigator) 方法，使你可以指定不同的位置来插入返回的数据。

构造函数

SharePointListRWQueryConnection()

代表用于从 SharePoint 列表或文档库检索数据的数据连接。

属性

ContentTypeId	获取或设置与 对象关联的 SharePoint 列表的 SharePointListRWQueryConnection 内容类型 ID。
ListId	获取或设置与 对象关联的 SharePoint 列表的列表 SharePointListRWQueryConnection ID。
Name	获取数据连接的名称。 (继承自 DataConnection)
SiteUrl	获取或设置一个 Uri 对象，该对象表示与 Microsoft.Office.InfoPath.SharepointListRWQueryConnection 对象关联的 SharePoint Foundation 网站的 URL。

方法

Execute()	根据从中调用数据连接的 ConnectionTypeConnection 类，使用以声明形式为已提交数据、查询参数或要检索的数据定义的值，在数据连接上执行提交或查询操作。 (继承自 DataConnection)
Execute(XPathNavigator)	重写默认 Execute() 方法以启用指定其他位置以插入返回的数据。