记录对象 (ADO)

  • 项目

表示来自 Recordset 或数据提供程序的行，或由半结构化数据提供程序返回的对象（如文件或目录）。

注解

一个 Record 对象表示一行数据，并且在概念上与单行 Recordset 有相似之处。 视提供程序的功能而定，Record 对象可能会直接从提供程序（而不是单行 Recordset）返回，例如，在执行一个仅选择一行的 SQL 查询时。 或者，可以直接从 Recordset 对象获取 Record 对象。 或者，Record 可以直接从提供程序返回到半结构化数据，例如 Microsoft Exchange OLE DB 提供程序。

可以通过 Record 对象上的 Fields 集合来查看与 Record 对象关联的字段。 ADO 允许对象值列（包括 Recordset、SafeArray）以及 Record 对象的 Fields 集合中的标量值。

如果 Record 对象表示 Recordset 中的单行，则可能可以使用 Source 属性返回到该原始 Recordset。

Record 对象还可以由半结构化数据提供程序（如用于 Internet 发布的 Microsoft OLE DB 提供程序）用来对树状结构命名空间进行建模。 树中的每个节点都是具有关联列的 Record 对象。 这些列可以表示该节点的特性和其他相关信息。 Record 对象可以表示树结构中的叶节点和非叶节点。 非叶节点将其他节点作为其内容，但叶节点没有此类内容。 叶节点通常包含数据的二进制流，非叶节点也可能有相关联的默认二进制流。 Record 对象上的属性标识了节点的类型。

Record 对象还表示一种用于在分层组织的数据中导航的替代方法。 可以创建 Record 对象来表示大型树结构中特定子树的根，并且可以打开新的 Record 对象来表示子节点。

资源（例如，文件或目录）可以由绝对 URL 唯一标识。 当使用绝对 URL 打开 Record 时，会隐式创建 Connection 对象并将其设置为 Record 对象。 可以通过 ActiveConnection 属性将 Connection 对象显式设置为 Record 对象。 可通过 Connection 对象访问的文件和目录定义了可能发生 Record 操作的上下文。

Record 对象上的数据修改和导航方法也接受相对 URL，该 URL 使用绝对 URL 或 Connection 对象上下文作为起点来定位资源。

注意

使用 http 方案的 URL 将自动调用用于 Internet 发布的 Microsoft OLE DB 提供程序。 有关详细信息，请参阅绝对 URL 和相对 URL。

一个 Connection 对象是与每个 Record 对象相关联的。 因此，Record 对象操作可以通过调用 Connection 对象事务方法来成为事务的一部分。

Record 对象不支持 ADO 事件，因此不会响应通知。

使用 Record 对象的方法和属性，可以执行以下操作：

  • 使用 ActiveConnection 属性设置或返回关联的 Connection 对象。

  • 使用 Mode 属性指示访问权限。

  • 使用 ParentURL 属性返回目录的 URL（如果有），该目录包含由 Record 表示的资源。

  • 使用 Source 属性指示从中派生 Record 的绝对 URL、相对 URL 或 Recordset。

  • 使用 State 属性指示 Record 的当前状态。

  • 使用 RecordType 属性指示 Record - 简单文档、集合或结构化文档的类型。

  • 使用 Cancel 方法停止执行异步操作。

  • 使用 Close 方法将 Record 与数据源取消关联。

  • 使用 CopyRecord 方法将 Record 表示的文件或目录复制到其他位置。

  • 使用 DeleteRecord 方法删除由 Record 表示的文件或目录和子目录。

  • 使用 GetChildren 方法打开一个 Recordset，其中包含表示由 Record 表示的实体的子目录和文件的行。

  • 使用 MoveRecord 方法将 Record 所表示的文件或目录和子目录移动（重命名）到另一个位置。

  • 使用 Open 方法将 Record 与现有数据源相关联，或创建新文件或目录。

Record 对象可以安全地用于编写脚本。

本部分包含以下主题。

另请参阅

字段集合 (ADO)
属性集合 (ADO)
记录和流
记录集对象 (ADO)