记录对象 (ADO)

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

言论

Record 对象表示一行数据,并且具有一行 Recordset的概念相似之处。 根据提供程序的功能,记录 对象可以直接从提供程序返回,而不是单行 Recordset,例如,仅执行选择一行的 SQL 查询时。 或者,可以直接从 Recordset 对象获取 Record 对象。 或者,记录 可以直接从提供程序返回到半结构化数据,例如 Microsoft Exchange OLE DB 访问接口。

可以通过 Record 对象的 Fields 集合查看与 Record 对象关联的字段。 ADO 允许对象值列,包括 RecordsetSafeArray,以及 Record 对象的 Fields 集合中的标量值。

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

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

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

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

Record 对象上的数据修改和导航方法也接受相对 URL,该 URL 使用绝对 URL 或 连接 对象上下文作为起点查找资源。

注意

使用 http 方案的 URL 将自动调用 Microsoft OLE DB Provider for Internet Publishing。 有关详细信息,请参阅 绝对 URL 和相对 URL

Connection 对象与每个 Record 对象相关联。 因此,记录 对象操作可以通过调用 连接 对象事务方法成为事务的一部分。

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

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

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

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

  • 返回包含 RecordParentURL 属性表示的资源的目录 URL(如果有)。

  • 指示 Source 属性从中派生 记录 的绝对 URL、相对 URL 或 Recordset

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

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

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

  • 记录Close 方法取消关联。

  • 使用 CopyRecord 方法将 记录 表示的文件或目录复制到另一个位置。

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

  • 打开一个 Recordset,其中包含一些行,这些行代表 Record 的实体的子目录和文件,GetChildren 方法。

  • 使用 moveRecord 方法将 Record 表示的文件或目录和子目录移动到另一个 位置。

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

Record 对象对于脚本是安全的。

本节包含以下主题。

另请参阅

Fields 集合 (ADO)
属性集合 (ADO)
记录和流
Recordset 对象 (ADO)