ADO参考手册

最新推荐文章于 2025-08-19 14:26:49 发布

转载最新推荐文章于 2025-08-19 14:26:49 发布 · 701 阅读

Connection对象

ADO Connection 对象用于创建一个到达某个数据源的开放连接。通过此连接，您可以对一个数据库进行访问和操作。

如果需要多次访问某个数据库，您应当使用 Connection 对象来建立一个连接。您也可以经由一个 Command 或 Recordset 对象传递一个连接字符串来创建某个连接。不过，此类连接仅仅适合一次具体的简单的查询。

属性

属性	描述
Attributes	设置或返回 Connection 对象的属性。
CommandTimeout	指示在终止尝试和产生错误之前执行命令期间需等待的时间。
ConnectionString	设置或返回用于建立连接数据源的细节信息。
ConnectionTimeout	指示在终止尝试和产生错误前建立连接期间所等待的时间。
CursorLocation	设置或返回游标服务的位置。
DefaultDatabase	指示 Connection 对象的默认数据库。
IsolationLevel	指示 Connection 对象的隔离级别。
Mode	设置或返回 provider 的访问权限。
Provider	设置或返回 Connection 对象提供者的名称。
State	返回一个描述连接是打开还是关闭的值。
Version	返回 ADO 的版本号。

方法

方法	描述
BeginTrans	开始一个新事务。
Cancel	取消一次执行。
Close	关闭一个连接。
CommitTrans	保存任何更改并结束当前事务。
Execute	执行查询、SQL 语句、存储过程或 provider 具体文本。
Open	打开一个连接。
OpenSchema	从 provider 返回有关数据源的 schema 信息。
RollbackTrans	取消当前事务中所作的任何更改并结束事务。

事件

事件	描述
BeginTransComplete	在 BeginTrans 操作之后被触发。
CommitTransComplete	在 CommitTrans 操作之后被触发。
ConnectComplete	在一个连接开始后被触发。
Disconnect	在一个连接结束之后被触发。
ExecuteComplete	在一条命令执行完毕后被触发。
InfoMessage	假如在一个 ConnectionEvent 操作过程中警告发生，则触发该事件。
RollbackTransComplete	在 RollbackTrans 操作之后被触发。
WillConnect	在一个连接开始之前被触发。
WillExecute	在一条命令被执行之前被触发。

集合

集合	描述
Errors	包含 Connection 对象的所有 Error 对象。
Properties	包含 Connection 对象的所有 Property 对象。

Command对象

ADO Command 对象用于执行面向数据库的一次简单查询。此查询可执行诸如创建、添加、取回、删除或更新记录等动作。

如果该查询用于取回数据，此数据将以一个 RecordSet 对象返回。这意味着被取回的数据能够被 RecordSet 对象的属性、集合、方法或事件进行操作。

Command 对象的主要特性是有能力使用存储查询和带有参数的存储过程。

属性

属性	描述
ActiveConnection	设置或返回包含了定义连接或 Connection 对象的字符串。
CommandText	设置或返回包含提供者（provider）命令（如 SOL 语句、表格名称或存储的过程调用）的字符串值。默认值为 ""（零长度字符串）。
CommandTimeout	设置或返回长整型值，该值指示等待命令执行的时间（单位为秒）。默认值为 30。
CommandType	设置或返回一个 Command 对象的类型
Name	设置或返回一个 Command 对象的名称
Prepared	指示执行前是否保存命令的编译版本（已经准备好的版本）。
State	返回一个值，此值可描述该 Command 对象处于打开、关闭、连接、执行还是取回数据的状态。

方法

方法	描述
Cancel	取消一个方法的一次执行。
CreateParameter	创建一个新的 Parameter 对象
Execute	执行 CommandText 属性中的查询、SQL 语句或存储过程。

集合

集合	描述
Parameters	包含一个 Command 对象的所有 Parameter 对象。
Properties	包含一个 Command 对象的所有 Property 对象。

Recordset对象

ADO Recordset 对象用于容纳一个来自数据库表的记录集。一个 Recordset 对象由记录和列（字段）组成。

在 ADO 中，此对象是最重要且最常用于对数据库的数据进行操作的对象。

属性

属性	描述
AbsolutePage	设置或返回一个可指定 Recordset 对象中页码的值。
AbsolutePosition	设置或返回一个值，此值可指定 Recordset 对象中当前记录的顺序位置（序号位置）。
ActiveCommand	返回与 Recordset 对象相关联的 Command 对象。
ActiveConnection	如果连接被关闭，设置或返回连接的定义，如果连接打开，设置或返回当前的 Connection 对象。
BOF	如果当前的记录位置在第一条记录之前，则返回 true，否则返回 fasle。
Bookmark	设置或返回一个书签。此书签保存当前记录的位置。
CacheSize	设置或返回能够被缓存的记录的数目。
CursorLocation	设置或返回游标服务的位置。
CursorType	设置或返回一个 Recordset 对象的游标类型。
DataMember	设置或返回要从 DataSource 属性所引用的对象中检索的数据成员的名称。
DataSource	指定一个包含要被表示为 Recordset 对象的数据的对象。
EditMode	返回当前记录的编辑状态。
EOF	如果当前记录的位置在最后的记录之后，则返回 true，否则返回 fasle。
Filter	返回一个针对 Recordset 对象中数据的过滤器。
Index	设置或返回 Recordset 对象的当前索引的名称。
LockType	设置或返回当编辑 Recordset 中的一条记录时，可指定锁定类型的值。
MarshalOptions	设置或返回一个值，此值指定哪些记录被返回服务器。
MaxRecords	设置或返回从一个查询返回 Recordset 对象的的最大记录数目。
PageCount	返回一个 Recordset 对象中的数据页数。
PageSize	设置或返回 Recordset 对象的一个单一页面上所允许的最大记录数。
RecordCount	返回一个 Recordset 对象中的记录数目。
Sort	设置或返回一个或多个作为 Recordset 排序基准的字段名。
Source	设置一个字符串值，或一个 Command 对象引用，或返回一个字符串值，此值可指示 Recordset 对象的数据源。
State	返回一个值，此值可描述是否 Recordset 对象是打开、关闭、正在连接、正在执行或正在取回数据。
Status	返回有关批更新或其他大量操作的当前记录的状态。
StayInSync	设置或返回当父记录位置改变时对子记录的引用是否改变。

方法

方法	描述
AddNew	创建一条新记录。
Cancel	撤销一次执行。
CancelBatch	撤销一次批更新。
CancelUpdate	撤销对 Recordset 对象的一条记录所做的更改。
Clone	创建一个已有 Recordset 的副本。
Close	关闭一个 Recordset。
CompareBookmarks	比较两个书签。
Delete	删除一条记录或一组记录。
Find	搜索一个 Recordset 中满足指定某个条件的一条记录。
GetRows	把多条记录从一个 Recordset 对象中拷贝到一个二维数组中。
GetString	将 Recordset 作为字符串返回。
Move	在 Recordset 对象中移动记录指针。
MoveFirst	把记录指针移动到第一条记录。
MoveLast	把记录指针移动到最后一条记录。
MoveNext	把记录指针移动到下一条记录。
MovePrevious	把记录指针移动到上一条记录。
NextRecordset	通过执行一系列命令清除当前 Recordset 对象并返回下一个 Recordset。
Open	打开一个数据库元素，此元素可提供对表的记录、查询的结果或保存的 Recordset 的访问。
Requery	通过重新执行对象所基于的查询来更新 Recordset 对象中的数据。
Resync	从原始数据库刷新当前 Recordset 中的数据。
Save	把 Recordset 对象保存到 file 或 Stream 对象中。
Seek	搜索 Recordset 的索引以快速定位与指定的值相匹配的行，并使其成为当前行。
Supports	返回一个布尔值，此值可定义 Recordset 对象是否支持特定类型的功能。
Update	保存所有对 Recordset 对象中的一条单一记录所做的更改。
UpdateBatch	把所有 Recordset 中的更改存入数据库。请在批更新模式中使用。

事件

事件	描述
EndOfRecordset	当试图移动到超过 Recordset 结尾的行时被触发。
FetchComplete	当异步操作中的所有记录均被读取后被触发。
FetchProgress	在异步操作期间被定期地触发，报告已读取多少记录。
FieldChangeComplete	Field 对象的值更改被触发。
MoveComplete	Recordset 中的当前位置更改后被触发。
RecordChangeComplete	一条记录更改之后被触发。
RecordsetChangeComplete	在 Recordset 更改之后被触发。
WillChangeField	在 Field 对象的值更改之前被触发
WillChangeRecord	在一条记录更改之前被触发。
WillChangeRecordset	在 Recordset 更改之前被触发。
WillMove	在 Recordset 中的当前位置更改之前被触发。

集合

集合	描述
Fields	指示在此 Recordset 对象中 Field 对象的数目。
Properties	包含所有 Recordset 对象中的 Property 对象。

Fields集合的属性

属性	描述
Count	返回 fields 集合中项目的数目。以 0 起始。例子： countfields = rs.Fields.Count
Item(named_item/number)	返回 fields 集合中的某个指定的项目。例子： itemfields = rs.Fields.Item(1) 或者 itemfields = rs.Fields.Item("Name")

属性

描述

Count

返回 fields 集合中项目的数目。以 0 起始。

例子：

countfields = rs.Fields.Count

Item(named_item/number)

返回 fields 集合中的某个指定的项目。

例子：

itemfields = rs.Fields.Item(1) 或者 itemfields = rs.Fields.Item("Name")

Properties集合的属性

属性	描述
Count	返回 properties 集合中项目的数目。以 0 起始。例子： countprop = rs.Properties.Count
Item(named_item/number)	返回 properties 集合中某个指定的项目。例子： itemprop = rs.Properties.Item(1) 或者 itemprop = rs.Properties.Item("Name")

属性

描述

Count

返回 properties 集合中项目的数目。以 0 起始。

例子：

countprop = rs.Properties.Count

Item(named_item/number)

返回 properties 集合中某个指定的项目。

例子：

itemprop = rs.Properties.Item(1) 或者 itemprop = rs.Properties.Item("Name")

Field 对象

ADO Field 对象包含有关 Recordset 对象中某一列的信息。Recordset 中的每一列对应一个 Field 对象。

属性

属性	描述
ActualSize	返回一个字段值的实际长度。
Attributes	设置或返回 Field 对象的属性。
DefinedSize	返回Field 对象被定义的大小
Name	设置或返回 Field 对象的名称。
NumericScale	设置或返回 Field 对象中的值所允许的小数位数。
OriginalValue	返回某个字段的原始值。
Precision	设置或返回当表示 Field 对象中的数值时所允许的数字的最大数。
Status	返回 Field 对象的状态。
Type	设置或返回 Field 对象的类型。
UnderlyingValue	返回一个字段的当前值。
Value	设置或返回 Field 对象的值。

方法

方法	描述
AppendChunk	把大型的二进制或文本数据追加到 Field 对象
GetChunk	返回大型二进制或文本 Field 对象的全部或部分内容。

集合

集合	描述
Properties	包含一个 Field 对象的所有 Property 对象。

Parameter 对象

ADO Parameter 对象可提供有关被用于存储过程或查询中的一个单个参数的信息。

Parameter 对象在其被创建时被添加到 Parameters 集合。Parameters 集合与一个具体的 Command 对象相关联，Command 对象使用此集合在存储过程和查询内外传递参数。

参数被用来创建参数化的命令。这些命令（在它们已被定义和存储之后）使用参数在命令执行前来改变命令的某些细节。例如，SQL SELECT 语句可使用参数定义 WHERE 子句的匹配条件，而使用另一个参数来定义 SORT BY 子句的列的名称。

有四种类型的参数：input 参数、output 参数、input/output 参数以及 return 参数。

属性

属性	描述
Attributes	设置或返回一个 Parameter 对象的属性。
Direction	设置或返回某个参数如何传递到存储过程或从存储过程传递回来。
Name	设置或返回一个 Parameter 对象的名称。
NumericScale	设置或返回一个 Parameter 对象的数值的小数点右侧的数字数目。
Precision	设置或返回当表示一个参数中数值时所允许数字的最大数目。
Size	设置或返回 Parameter 对象中的值的最大大小（按字节或字符）。
Type	设置或返回一个 Parameter 对象的类型。
Value	设置或返回一个 Parameter 对象的值。