下载附录 E ADO 2.5对象模型
2,5版本中新增的属性和方法用斜体列出。除非声明，否则所有属性都是读 /写属性。
E.1 ADO对象
A D O对象的名称及说明如表 E - 1所示。
表 E-1 ADO对象的名称及说明名 称 说 明
C o m m a n d C o m m a n d对象是指定命令的一个定义，可使用该命令执行对数据源的操作
C o n n e c t i o n C o n n e c t i o n对象表示一个打开的与数据源的连接
E r r o r E r r o r对象包含了涉及提供者的简单操作的有关数据访问错误的详细情况
E r r o r s E r r o r s集合包含了涉及提供者的响应单个错误而创建的所有 E r r o r对象
F i e l d F i e l d对象代表普通的数据类型内的一列数据
F i e l d s F i e l d s集合包含了一个 R e c o r d s e t对象的所有 F i e l d对象
P a r a m e t e r P a r a m e t e r代表一个与基于参数化查询或存储过程的 C o m m a n d对象有关的参数
P a r a m e t e r s P a r a m e t e r s集合包含一个 C o m m a n d对象的全部 P a r a m e t e r对象
P r o p e r t i e s P r o p e r t i e s集合是包含一个对象特定实例的所有的 P r o p e r t y对象
P r o p e r t y P r o p e r t y对象代表由提供者定义的 A D O对象的一个动态特征
R e c o r d R e c o r d对象代表在文件系统或 We b资源中的一个文件或一个目录，或记录集中的一个记录
R e c o r d s e t R e c o r d s e t对象代表一个表的全部记录或执行命令的结果。在任何时候,R e c o r d s e t对象仅指向全部记录中的一个记录，作为当前记录
S t re a m S t r e a m对象代表文本或二进制数据的流
E.2 Command对象
C o m m a n d对象的方法、属性、返回值类型及说明分别如表 E - 2和表 E - 3所示。
表 E-2 Command对象的方法、返回值类型及说明方 法 返回值类型 说 明
C a n c e l 取消未完成的 E x e c u t e或 O p e n调用的执行
C r e a t e P a r a m e t e r P a r a m e t e r 创建一个新的 P a r a m e t e r对象
E x e c u t e R e c o r d s e t 执行由 C o m m a n d Te x t属性指定的存储过程、查询或 S Q L语句表 E-3 Command对象的属性、返回值类型及说明属 性 返回值类型 说 明
A c t i v e C o n n e c t i o n Va r i a n t 指明当前命令所属的 C o n n e c t i o n对象
C o m m a n d Te x t 字符串型 包含要对数据提供者发出的命令的文本
(续 )
属 性 返回值类型 说 明
C o m m a n d Ti m e o u t 长整型 指明在结束命令并产生错误之前执行命所要等待令的时间，缺省值为 3 0秒
C o m m a n d Ty p e Command Ty p e E n u m 指明 C o m m a n d对象的类型
N a m e 字符串型 指明 C o m m a n d对象的名字
P a r a m e t e r s P a r a m e t e r s 包含 C o m m a n d对象的所有 P a r a m e t e r对象
P r e p a r e d 布尔型 指出是否在执行之前保存命令的编译版本
P r o p e r t i e s P r o p e r t i e s 包含 C o m m a n d对象的所有 P r o p e r t y对象
S t a t e 长整型 描述 C o m m a n d对象是被打开还是被关闭。只读
E.3 Connection对象
C o n n e c t i o n对象的方法、属性和事件分别如表 E - 4和 E - 5所示。
表 E-4 Connection对象的方法方 法 返回值类型 说 明
B e g i n Tr a n s 整型 开始一个新事务
C a n c e l 删除正在异步执行的 E x e c u t e或 O p e n操作
C l o s e 关闭一个打开的连接和任何相关的对象
C o m m i t Tr a n s 保留任何变化并结束当前的事务
E x e c u t e R e c o r d s e t 执行 S Q L语句、存储过程、查询或提供者指定的文本
O p e n 打开一个到数据源的连接，以便命令能对其运行
O p e n S c h e m a R e c o r d s e t 从提供者获得数据库模式信息
R o l l b a c k Tr a n s 取消当前事务的所有改变，终止事务表 E-5 Connection对象的属性属 性 返回值类型 说 明
A t t r i b u t e s 长整型 指出 C o n n e c t i o n对象的特性个数，缺省为 0
C o m m a n d Ti m e o u t 长整型 指明在结束命令并产生错误之前执行命令所要等待的时间，缺省值为 3 0秒
C o n n e c t i o n S t r i n g 字符串型 包含用于建立与数据源的连接的信息。
C o n n e c t i o n Ti m e o u t 长整型 指明在结束并产生错误之前建立一个连接所要等待的时间，缺省值为 1 5秒
C u r s o r L o c a t i o n C u r s o r L o c a t i o n E n u m 设置或返回光标引擎的位置
D e f a u l t D a t a b a s e 字符串型 指出 C o n n e c t i o n对象的缺省数据库
E r r o r s E r r o r s 包含涉及提供者的响应单个错误而创建的所有 E r r o r
对象
Isolati nlevel I s o l a t i o n L e v e lEn u m 指出用于 C o n n e c t i o n对象的事务隔离级别。只写
M o d e C o n n e c t M o d e E n u m 指出在 C o n n e c t i o n对象中修改数据可用的权限
P r o p e r t i e s P r o p e r t i e s 包括一个 C o n n e c t i o n对象的全部 P r o p e r t y对象
P r o v i d e r 字符串型 指出 C o n n e c t i o n对象的提供者
S t a t e 长整型 指出 C o n n e c t i o n对象是打开还是关闭的。只读
Ve r s i o n 字符串型 指出 A D O的版本号。只读
894计计 ASP 3 高级编程 下载表 E-6 Connection对象的事件事 件 说 明
B e g i n Tr a n s C o m p l e t e 在 B e g i n Tr a n操作结束后触发
C o m m i tTr a n s C o m p l a t e 在 C o m m i t Tr a n s操作结束后触发
C o n n e c t C o m p l e t e 在连接开始后触发
D i s c o n n c t 在连接结束后触发
E x e c u t e C o m p l e t e 在命令执行结束后触发。
I n f o M e s s a g e 只要成功地完成 C o n n e c t i o n E v e n t操作并且提供者返回了附加的信息，随时可以触发
R o l l b a c k Tr a n s C o m p l e t e 在 R o l l b a c k Tr a n s操作结束后触发
Wi l lCo n n e c t 在连接开始前触发
Wi l l E x e c u t e 在一个连接上执行命令之前触发
E.4 Error对象
E r r o r对象的属性如表 E - 7所示。
表 E-7 Error对象的属性属 性 返回值类型 说 明
D e s c r i p t i o n 字符型 一个与错误相关的描述字符串，只读
H e l p C o n t e x t 整型 指出与错误相关的帮助文件的 C o n t e x t I D，只读
H e l p F i l e 字符型 指出帮助文件的名字，只读
N a t i v e E r r o r 长整型 指出与错误相关的提供者指定的错误代码，只读
N u m b e r 长整型 指出唯一识别 E r r o r对象的数字，只读
S o u r c e 字符串型 指出产生的错误的应用程序或对象的名称
S Q L S t a t e 字符串型 指出给定 E r r o r对象的 S Q L状态，这是符合 ANSI SQL标准的 5个字符的字符串，只读
E.5 Errors集合
E r r o r s集合的方法和属性分别如表 E - 8、表 E - 9所示。
表 E-8 Errors集合的方法方 法 返回值类型 说 明
C l e a r 从 E r r o r s集合中清除所有的 E r r o r对象
R e f r e s h 用提供者提供的信息更新 E r r o r对象，只读表 E-9 Errors集合的属性属 性 返回值类型 说 明
C o u n t 长整型 指出 E r r o r s集合中 E r r o r对象的数目，只读
I t e m E r r o 允许索引到 E r r o r s集合内，引用一个指定的 E r r o r对象，只读
E.6 Field对象
F i e l d对象的方法和属性分别如表 E - 1 0、表 E - 11所示。
附录 E ADO 2.5 对象模型 计计 895下载表 E-10 Field对象的方法方 法 返回值类型 说 明
A p p e n dCh u n k 附加数据给大型的或者二进制的 F i e l d对象
G e tCh u n k Va r i a n t 返回一个大型的或者二进制的 F i e l d对象的所有或部分内容表 E - 11 Field对象的属性属 性 返回值类型 说 明
A c t u a l S i z e 长整型 指出字段值的实际长度，只读
A t t r i b u t e s 长整型 指出一个 F i e l d对象的属性个数
D a t a F o r m a t Va r i a n t 指出要求的数据显示格式
D e f i n e d S i z e 长整型 指出 F i e l d对象定义的大小，只写
N a m e 字符串型 指出 F i e l d对象的名称
N u m e r i c S c a l e 字节型 指出 F i e l d对象的数值范围，只写
O r i g i n a l Va l u e Va r i a n t 指出在变化前存在于记录中的 F i e l d对象的值，只读
P r e c i s i o n 字节型 指出 F i e l d对象的数值精度，只读
P r o p e r t i e s P r o p e r t i e s 包含一个 F i e l d对象的全部 P r o p e r t y对象，只读
Ty p e D a t a Ty p e E n u m 指出 F i e l d对象的数据类型
U n d e r l y i n g Va l u e Va r i a n t 指出一个 F i e l d对象在数据库中的当前值，只读
Va l u e Va r i a n t 指出赋给 F i e l d对象的值
E.7 Fields集合
F i e l d s集合的方法和属性分别如表 E - 1 2、表 E - 1 3所示。
表 E-12 Fields集合的方法方 法 返回值类型 说 明
A p p e n d 向 F i e l d s集合追加一个 F i e l d对象
C a n c e lUp d a t e 撤消对 F i e l d s集合做的任何改动
D e l e t e 从 F i e l d s集合中删除一个 F i e l d对象
R e f r e s h 更新 F i e l d s集合中的 F i e l d对象
R e s y n c 重新同步 F i e l d s集合中的数据
U p d a t e 存储对 F i e l d s集合所做的改变表 E-13 Fields集合的属性属 性 返回值类型 说 明
C o u n t 长整型 指出 F i e l d s集合中 F i e l d对象的数目，只读
I t e m F i e l d 允许索引到 F i e l d s集合内，引用一个指定的 F i e l d对象，只读
E.8 Parameter对象
P a r a m e t e r对象的方法和属性分别如表 E - 1 4、表 E - 1 5所示。
896计计 ASP 3 高级编程 下载表 E-14 Parameter对象的方法方 法 返回值类型 说 明
A p p e n dCh u n k 向大型的或者二进制的 P a r a m e t e r对象追加数据表 E-15 Parameter对象的属性属 性 返回值类型 说 明
A t t r i b u t e s 长整型 指出 P a r a m e t e r对象的特性个数
D i r e c t i o n P a r a m e t e r D i r e c t i o n E n u m 指出 P a r a m e t e r对象是输入参数、输出参数或双向参数，参数是否从存储过程中返回值
N a m e 字符串型 指出 P a r a m e t e r对象的名称
N u m e r i c S c a l e 字节型 指出 P a r a m e t e r对象的数值范围
P r e c i s i o n 字节型 指出 P a r a m e t e r对象的数值精度
P r o p e r t i e s P r o p e r t i e s 包含一个 P a r a m e t e r对象的全部 P r o p e r t y对象
S i z e 长整型 指出 P a r a m e t e r对象的最大大小，单位为字符或字节
Ty p e D a t a Ty p e E n u m 指出 P a r a m e t e r对象的数据类型
Va l u e Va r i a n t 指出赋给 P a r a m e t e r对象的值
E.9 Parameters集合
P a r a m e t e r s集合的方法和属性分别如表 E - 1 6、表 E - 1 7所示。
表 E-16 Parameters集合的方法方 法 返回值类型 说 明
A p p e n d 向 P a r a m e t e r s集合追加一个 P a r a m e t e r对象
D e l e t 从 P a r a m e t e r s集合中删除一个 P a r a m e t e r对象
R e f r e s h 更新 P a r a m e t e r s集合中的 P a r a m e t e r对象表 E-17 Parameters集合的属性属 性 返回值类型 说 明
C o u n t 长整型 指出 P a r a m e t e r s集合中 P a r a m e t e r对象的数目，只读
I t e m P a r a m e t e r 允许索引到 P a r a m e t e r s集合内，引用一个指定的 P a r a m e t e r对象，只读
E.10 Properties集合
P r o p e r t i e s集合的方法和属性分别如表 E - 1 8、表 E - 1 9所示。
表 E-18 Properties集合的方法方 法 返回值类型 说 明
R e f r e s h 用提供者提供的细节更新 P r o p e r t i e s集合中的 P r o p e r t y对象表 E-19 Properties集合的属性属 性 返回值类型 说 明
C o u n t 长整型 指出 P r o p e r t i e s集合中 P r o p e r t y对象的数目，只读
I t e m P r o p e r t y 允许索引到 P r o p e r t i e s集合内，引用一个指定的 P r o p e r t y对象附录 E ADO 2.5 对象模型 计计 897下载
E,11 Property对象
P r o p e r t y对象的属性如表 E - 2 0所示。
表 E-20 Property对象的属性属 性 返回值类型 说 明
Attributes 长整型 指出 P r o p e r t y对象的特性个数
Name 字符串型 指出 P r o p e r t y对象的名称，只读
Type D a t a Ty p e E n u m 指出 P r o p e r t y对象的数据类型
Value Va r i a n t 指出赋给 P r o p e r t y对象的值
E.12 Record对象
R e c o r d对象的方法和属性分别如表 E - 2 1、表 E - 2 2所示。
表 E-21 Record对象的方法方 法 返回值类型 说 明
C a n c e l 撤消执行一个并步的 E x e c u t e或 O p e n操作
Close 关闭打开的记录
C o p y R e c o rd 字符串型 从一个位置复制一个文件、目录和 R e c o r d代表的对象到另一个位置
D e l e t e R e c o rd 删除一个文件、目录和 R e c o r d代表的对象
G e t C h i l d ren Recordset 返回一个记录集，包含 R e c o r d代表的目录下的文件和文件夹
M o v e R e c o rd 字符串型 从一个位置移动一个文件、目录和 R e c o r d代表的对象到另一个位置
Open 创建一个新的或打开一个现有的文件或目录表 E-22 Record对象的属性属 性 返回值类型 说 明
A c t i v e C o n n e c t i o n Va r i a n t 指出指定的 R e c o r d s e t对象当前属于哪个 C o n n e c t i o n对象
Fields F i e l d s 包含当前 R e c o r d s e t对象中的所有 F i e l d对象，只读
Mode C o n n e c t M o d e E n u m 指出修改 C o n n e c t i o n对象中数据的权限
P a rentURL 字符串型 指出当前 Record 对象的父 Record 对象的绝对 U R L，只读
P ro p e rt i e s P r o p e r t i e s 包含当前 R e c o r d s e t对象中的所有 P r o p r e t y对象，只读
R e c o rd Type R e c o r d Ty p e E n u m 指出 Record 对象是简单记录、结构化文档还是一个集合，
只读
S o u rce Va r i a n t 指出 Record 对象代表的是 U R L，还是到一个打开的记录集的引用
State O b j e c t S t a t e E n u m 指出记录是打开的还是关闭的，如果打开，显示异步活动的状态。只读
E.13 Recordset对象
R e c o r d s e t对象的方法和属性说明分别如表 E - 2 3、表 E - 2 4所示，其事件如表 E - 2 5所示。
898计计 ASP 3 高级编程 下载表 E-23 Recordset对象的方法方 法 返回值类型 说 明
Addnew 为可更新的 R e c o r d s e t对象创建一个新记录
Cancel 撤消执行一个异步的 E x e c u t e或 O p e n操作
C a n c e l B a t c h 撤消批更新
CancelUpdate 撤消对现在记录的任何改变
Clone Recordset 创建现有的 R e c o r d s e t对象的副本 Recordset 对象
Close 关闭 R e c o r d s e t对象及相关的任何对象
CompareBookmarks C o m p a r e E n u m 比较两个书签并返回一个相对值的指示
Deleate 删除当前记录或一组记录
Find 在记录集里寻找匹配给定标准的记录
GetRows Va r i a n t 将 R e c o r d s e t对象中的多个记录检索到一个数组中
GetString 字符串型 作为字符串返回一个 R e c o r d s e t
Move 移动记录集指针指向一个记录
M o v e F r i s t 移动记录集指针指向 R e c o r d s e t中的第一个记录
M o v e L a s t 移动记录集指针指向 Recordset 中的的最后一个记录
MoveNext 移动记录集指针指向 R e c o r d s e t中的下一个记录
M o v e P r e v i o u s 移动记录集指针指向 R e c o r d s e t中的前一个记录
NextRecordset R e c o r d s e t 清除当前的 R e c o r d s e t并用一组命令返回下一个 R e c o r d s e t
O p e n 打开一个 R e c o r d s e t
R e q u e r y 通过重新执行此对象所基于的查询，对 R e c o r d s e t对象的数据进行更新
R e s y n c 根据底层数据库刷新当前 R e c o r d s e t对象的数据
Save 将 R e c o r d s e t保存为一个文件
Seek 搜索记录集索引，查找一个值
Supports 布尔型 决定指定的 R e c o r d s e t对象是否支持某一功能
U p d a t e 保存对当前 R e c o r d s e t对象所做的所有改变
U p d a t e B a t c h 将所有的批更新写到磁盘表 E-24 Recordset对象的属性属 性 返回值类型 说 明
AbsolutePage P o s i t i o n E n u m 指定当前记录在哪一页上
A b s o l u t e P o s i t i o n P o s i t i o n E n u m 指定一个 R e c o r d s e t对象的当前记录的原始位置
ActiveCommand Object 指出创建相关 R e c o r d s e t对象的 C o m m a n d对象，只读
A c t i v e C o n n e c t i o n Va r i a n t 指出指定的 R e c o r d s e t对象当前属于哪个 C o n n e c t i o n对象
B O F 布尔型 指出当前的记录是否在 R e c o r d s e t对象的第一个记录之前，
只读
Bookmark Variant 返回一个在一个 R e c o r d s e t里唯一识别当前记录的书签，
或者把当前的记录设置为用一个有效的书签标识的记录
C a c h e S i z e 长整型 指出在内存中缓存的 R e c o r d s e t对象的记录数
C u r s o r L o c a t i o n C u r s o r Ty p e E n u m 设置或返回光标引擎的位置
C u r s o r Ty p e C u r s o r L o c a t i o n E n u m 指出 R e c o r d s e t对象中使用的光标类型
D a t a M e m b e r 字符串型 指定从由 D a t a S o u r c e属性引用的对象检索的数据成员的名称，只写
D a t a S o u r c e 对象 指定一个对象，它包含的数据由一个 R e c o r d s e t对象，只写
EditMode E d i t M o d e E n u m 指出当前记录的编辑状态，只读
E O F 布尔型 指出当前记录是否在 R e c o r d s e t对象的最后一个记录之后，
只读附录 E ADO 2.5 对象模型 计计 899下载
(续 )
属 性 返回值类型 说 明
Fields F i e l d s 包含当前的 R e c o r d s e t对象中的所有 F i e l d对象
F i l t e r Va r a n t 指出 Recordset 中的数据过滤器
In d e x 字符串型 当前所使用的索引的名称
L o c k Type L o c k Ty p e E n u m 指出编辑过程中放置在记录上的锁的类型
M a r s h a l O p t i o n s M a r s h a l O p t i o n s E n u m 指出哪些记录被调度回服务器
MaxRecords 长整型 指出从一次查询中返回到一个 R e c o r d s e t对象的最大记录数目，默认是零（无限制）
PageCount 长整型 指出 R e c o r d s e t对象包含多少页面，只读
P a g e S i z e 长整型 指出 R e c o r d s e t对象中每页由多少记录组成
Properties P r o p e r t i e s 包含当前的 R e c o r d s e t对象的所有 P r o p e r t y对象
R e c o r d C o u n t 长整型 指出当前的 R e c o r d s e t对象中有多少记录，只读
Sort 字符串型 指定 R e c o r d s e t对象用于排序的一个或多个字段名，并指定排序方向
Source 字符串型 指出 R e c o r d s e t对象的数据源
State 长整型 指出记录集是打开的还是关闭的，或者是否正在执行异步操作，只读
Status 整型 指出当前记录的有关更新或其他批操作的状态，只读
S t a y I n S y n c 布尔型 在一个分层 R e c o r d s e t对象里，指出当下级记录改变时上一级记录是否应该改变，只读表 E-25 Recordset对象的事件事 件 说 明
E n d O f R e c o r d s e t 当试图从 R e c o r d s e t对象的末尾移到下一行时触发
F e t c h C o m p l e t e 当在一个异步操作里所有的记录检索到 R e c o r d s e t对象后触发
F e t c h P r o g r e s s 在较长的异步操作期间内定期地触发，并且报告目前已经检索到的行数
F i e l d C h a n g e C o m p l e t e 当一个或几个字段的值改变完成后触发
M o v e C o m p l e t e R e c o r d s e t对象里的指针位置改变后触发
R e c o r d C h a n g e C o m p l e t e 一个或多个记录改变完成后触发
R e c o r d s e t C h a n g e C o m p l e t e R e c o r d s e t对象改变完成后触发
Wi l l C h a n g e F i e l d 在一个操作将要改变一个或多个字段的值之前触发
Wi l lCh a n g e R e c o r d 当 R e c o r d s e t对象里一行或多行改变前触发
Wi l l C h a n g e R e c o r d s e t 在一个操作改变 R e c o r d s e t对象前触发
WillMove 在一个操作改变 R e c o r d s e t对象里的指针位置前触发
E.14 Stream对象
S t r e a m对象的方法和属性分别如表 E - 2 6、表 E - 2 7所示。
表 E-26 Stream对象的方法方 法 返回值类型 说 明
C a n c l e 撤消一个未完成的异步 O p e n操作
C l o s e 关闭一个打开的 S t r e a m
C o p y To 从一个 S t r e a m到另一个 S t r e a m复制字符或字节
Flush 刷新 S t r e a m的内容到一个底层对象
L o a d F ro m F i l e 从一个文件里读取一个 S t r e a m
900计计 ASP 3 高级编程 下载
(续 )
方 法 返回值类型 说 明
O p e n 从一个存在的 R e c o r d或 U R L里打开一个 S t r e a m对象，或创建一个空的 S t r e a m
R e a d Va r i a n t 从一个 S t r e a m里读取一些字节
R e a d Te x a t 字符串型 从一个文本 S t r e a m里读取一些字符
S a v e To F i l e 存储一个打开的 S t r e a m到一个文件里
SetEOS 把当前的位置设置为 S t r e a m的末尾
S k i p L i n e 当从一个文本 S t r e a m里读取时跳过一行
Wr i t e 把二进制数据写进一个 S t r e a m里
Wr i t e Te x t 把文本数据写进一个 S t r e a m里表 E-27 Stream对象的属性属 性 返回值类型 说 明
c h a r s e t 字符串型 标识用于 S t r e a m的字符集
E O S 布尔型 如果当前的位置是 S t r e a m的末尾，设置为 Tr u e，只读
L i n e S e p a r a t o r L i n e S e p a r a t o r E n u m 指出文本 S t r e a m里用来分隔行的字符，默认是 V b C r L f
Mode C o n n e c t i o n M o d e E n u m 指出修改 C o n n e c t i o n里数据的可用的权限
P o s i t i o n 长整型 指定当前在 S t r e a m中的位置
S i z e 长整型 用字节指出 S t r e a m的长度，只读
S t a t e O b j e c t S t a t e E n u m 指出 S t r e a m是打开的还是关闭的，如果是打开的，指出异步活动的状态，只读
Ty p e S t r e a m Ty p e E n u m 指出 S t r e a m是包含文本还是包含二进制数据附录 E ADO 2.5 对象模型 计计 901下载
2,5版本中新增的属性和方法用斜体列出。除非声明，否则所有属性都是读 /写属性。
E.1 ADO对象
A D O对象的名称及说明如表 E - 1所示。
表 E-1 ADO对象的名称及说明名 称 说 明
C o m m a n d C o m m a n d对象是指定命令的一个定义，可使用该命令执行对数据源的操作
C o n n e c t i o n C o n n e c t i o n对象表示一个打开的与数据源的连接
E r r o r E r r o r对象包含了涉及提供者的简单操作的有关数据访问错误的详细情况
E r r o r s E r r o r s集合包含了涉及提供者的响应单个错误而创建的所有 E r r o r对象
F i e l d F i e l d对象代表普通的数据类型内的一列数据
F i e l d s F i e l d s集合包含了一个 R e c o r d s e t对象的所有 F i e l d对象
P a r a m e t e r P a r a m e t e r代表一个与基于参数化查询或存储过程的 C o m m a n d对象有关的参数
P a r a m e t e r s P a r a m e t e r s集合包含一个 C o m m a n d对象的全部 P a r a m e t e r对象
P r o p e r t i e s P r o p e r t i e s集合是包含一个对象特定实例的所有的 P r o p e r t y对象
P r o p e r t y P r o p e r t y对象代表由提供者定义的 A D O对象的一个动态特征
R e c o r d R e c o r d对象代表在文件系统或 We b资源中的一个文件或一个目录，或记录集中的一个记录
R e c o r d s e t R e c o r d s e t对象代表一个表的全部记录或执行命令的结果。在任何时候,R e c o r d s e t对象仅指向全部记录中的一个记录，作为当前记录
S t re a m S t r e a m对象代表文本或二进制数据的流
E.2 Command对象
C o m m a n d对象的方法、属性、返回值类型及说明分别如表 E - 2和表 E - 3所示。
表 E-2 Command对象的方法、返回值类型及说明方 法 返回值类型 说 明
C a n c e l 取消未完成的 E x e c u t e或 O p e n调用的执行
C r e a t e P a r a m e t e r P a r a m e t e r 创建一个新的 P a r a m e t e r对象
E x e c u t e R e c o r d s e t 执行由 C o m m a n d Te x t属性指定的存储过程、查询或 S Q L语句表 E-3 Command对象的属性、返回值类型及说明属 性 返回值类型 说 明
A c t i v e C o n n e c t i o n Va r i a n t 指明当前命令所属的 C o n n e c t i o n对象
C o m m a n d Te x t 字符串型 包含要对数据提供者发出的命令的文本
(续 )
属 性 返回值类型 说 明
C o m m a n d Ti m e o u t 长整型 指明在结束命令并产生错误之前执行命所要等待令的时间，缺省值为 3 0秒
C o m m a n d Ty p e Command Ty p e E n u m 指明 C o m m a n d对象的类型
N a m e 字符串型 指明 C o m m a n d对象的名字
P a r a m e t e r s P a r a m e t e r s 包含 C o m m a n d对象的所有 P a r a m e t e r对象
P r e p a r e d 布尔型 指出是否在执行之前保存命令的编译版本
P r o p e r t i e s P r o p e r t i e s 包含 C o m m a n d对象的所有 P r o p e r t y对象
S t a t e 长整型 描述 C o m m a n d对象是被打开还是被关闭。只读
E.3 Connection对象
C o n n e c t i o n对象的方法、属性和事件分别如表 E - 4和 E - 5所示。
表 E-4 Connection对象的方法方 法 返回值类型 说 明
B e g i n Tr a n s 整型 开始一个新事务
C a n c e l 删除正在异步执行的 E x e c u t e或 O p e n操作
C l o s e 关闭一个打开的连接和任何相关的对象
C o m m i t Tr a n s 保留任何变化并结束当前的事务
E x e c u t e R e c o r d s e t 执行 S Q L语句、存储过程、查询或提供者指定的文本
O p e n 打开一个到数据源的连接，以便命令能对其运行
O p e n S c h e m a R e c o r d s e t 从提供者获得数据库模式信息
R o l l b a c k Tr a n s 取消当前事务的所有改变，终止事务表 E-5 Connection对象的属性属 性 返回值类型 说 明
A t t r i b u t e s 长整型 指出 C o n n e c t i o n对象的特性个数，缺省为 0
C o m m a n d Ti m e o u t 长整型 指明在结束命令并产生错误之前执行命令所要等待的时间，缺省值为 3 0秒
C o n n e c t i o n S t r i n g 字符串型 包含用于建立与数据源的连接的信息。
C o n n e c t i o n Ti m e o u t 长整型 指明在结束并产生错误之前建立一个连接所要等待的时间，缺省值为 1 5秒
C u r s o r L o c a t i o n C u r s o r L o c a t i o n E n u m 设置或返回光标引擎的位置
D e f a u l t D a t a b a s e 字符串型 指出 C o n n e c t i o n对象的缺省数据库
E r r o r s E r r o r s 包含涉及提供者的响应单个错误而创建的所有 E r r o r
对象
Isolati nlevel I s o l a t i o n L e v e lEn u m 指出用于 C o n n e c t i o n对象的事务隔离级别。只写
M o d e C o n n e c t M o d e E n u m 指出在 C o n n e c t i o n对象中修改数据可用的权限
P r o p e r t i e s P r o p e r t i e s 包括一个 C o n n e c t i o n对象的全部 P r o p e r t y对象
P r o v i d e r 字符串型 指出 C o n n e c t i o n对象的提供者
S t a t e 长整型 指出 C o n n e c t i o n对象是打开还是关闭的。只读
Ve r s i o n 字符串型 指出 A D O的版本号。只读
894计计 ASP 3 高级编程 下载表 E-6 Connection对象的事件事 件 说 明
B e g i n Tr a n s C o m p l e t e 在 B e g i n Tr a n操作结束后触发
C o m m i tTr a n s C o m p l a t e 在 C o m m i t Tr a n s操作结束后触发
C o n n e c t C o m p l e t e 在连接开始后触发
D i s c o n n c t 在连接结束后触发
E x e c u t e C o m p l e t e 在命令执行结束后触发。
I n f o M e s s a g e 只要成功地完成 C o n n e c t i o n E v e n t操作并且提供者返回了附加的信息，随时可以触发
R o l l b a c k Tr a n s C o m p l e t e 在 R o l l b a c k Tr a n s操作结束后触发
Wi l lCo n n e c t 在连接开始前触发
Wi l l E x e c u t e 在一个连接上执行命令之前触发
E.4 Error对象
E r r o r对象的属性如表 E - 7所示。
表 E-7 Error对象的属性属 性 返回值类型 说 明
D e s c r i p t i o n 字符型 一个与错误相关的描述字符串，只读
H e l p C o n t e x t 整型 指出与错误相关的帮助文件的 C o n t e x t I D，只读
H e l p F i l e 字符型 指出帮助文件的名字，只读
N a t i v e E r r o r 长整型 指出与错误相关的提供者指定的错误代码，只读
N u m b e r 长整型 指出唯一识别 E r r o r对象的数字，只读
S o u r c e 字符串型 指出产生的错误的应用程序或对象的名称
S Q L S t a t e 字符串型 指出给定 E r r o r对象的 S Q L状态，这是符合 ANSI SQL标准的 5个字符的字符串，只读
E.5 Errors集合
E r r o r s集合的方法和属性分别如表 E - 8、表 E - 9所示。
表 E-8 Errors集合的方法方 法 返回值类型 说 明
C l e a r 从 E r r o r s集合中清除所有的 E r r o r对象
R e f r e s h 用提供者提供的信息更新 E r r o r对象，只读表 E-9 Errors集合的属性属 性 返回值类型 说 明
C o u n t 长整型 指出 E r r o r s集合中 E r r o r对象的数目，只读
I t e m E r r o 允许索引到 E r r o r s集合内，引用一个指定的 E r r o r对象，只读
E.6 Field对象
F i e l d对象的方法和属性分别如表 E - 1 0、表 E - 11所示。
附录 E ADO 2.5 对象模型 计计 895下载表 E-10 Field对象的方法方 法 返回值类型 说 明
A p p e n dCh u n k 附加数据给大型的或者二进制的 F i e l d对象
G e tCh u n k Va r i a n t 返回一个大型的或者二进制的 F i e l d对象的所有或部分内容表 E - 11 Field对象的属性属 性 返回值类型 说 明
A c t u a l S i z e 长整型 指出字段值的实际长度，只读
A t t r i b u t e s 长整型 指出一个 F i e l d对象的属性个数
D a t a F o r m a t Va r i a n t 指出要求的数据显示格式
D e f i n e d S i z e 长整型 指出 F i e l d对象定义的大小，只写
N a m e 字符串型 指出 F i e l d对象的名称
N u m e r i c S c a l e 字节型 指出 F i e l d对象的数值范围，只写
O r i g i n a l Va l u e Va r i a n t 指出在变化前存在于记录中的 F i e l d对象的值，只读
P r e c i s i o n 字节型 指出 F i e l d对象的数值精度，只读
P r o p e r t i e s P r o p e r t i e s 包含一个 F i e l d对象的全部 P r o p e r t y对象，只读
Ty p e D a t a Ty p e E n u m 指出 F i e l d对象的数据类型
U n d e r l y i n g Va l u e Va r i a n t 指出一个 F i e l d对象在数据库中的当前值，只读
Va l u e Va r i a n t 指出赋给 F i e l d对象的值
E.7 Fields集合
F i e l d s集合的方法和属性分别如表 E - 1 2、表 E - 1 3所示。
表 E-12 Fields集合的方法方 法 返回值类型 说 明
A p p e n d 向 F i e l d s集合追加一个 F i e l d对象
C a n c e lUp d a t e 撤消对 F i e l d s集合做的任何改动
D e l e t e 从 F i e l d s集合中删除一个 F i e l d对象
R e f r e s h 更新 F i e l d s集合中的 F i e l d对象
R e s y n c 重新同步 F i e l d s集合中的数据
U p d a t e 存储对 F i e l d s集合所做的改变表 E-13 Fields集合的属性属 性 返回值类型 说 明
C o u n t 长整型 指出 F i e l d s集合中 F i e l d对象的数目，只读
I t e m F i e l d 允许索引到 F i e l d s集合内，引用一个指定的 F i e l d对象，只读
E.8 Parameter对象
P a r a m e t e r对象的方法和属性分别如表 E - 1 4、表 E - 1 5所示。
896计计 ASP 3 高级编程 下载表 E-14 Parameter对象的方法方 法 返回值类型 说 明
A p p e n dCh u n k 向大型的或者二进制的 P a r a m e t e r对象追加数据表 E-15 Parameter对象的属性属 性 返回值类型 说 明
A t t r i b u t e s 长整型 指出 P a r a m e t e r对象的特性个数
D i r e c t i o n P a r a m e t e r D i r e c t i o n E n u m 指出 P a r a m e t e r对象是输入参数、输出参数或双向参数，参数是否从存储过程中返回值
N a m e 字符串型 指出 P a r a m e t e r对象的名称
N u m e r i c S c a l e 字节型 指出 P a r a m e t e r对象的数值范围
P r e c i s i o n 字节型 指出 P a r a m e t e r对象的数值精度
P r o p e r t i e s P r o p e r t i e s 包含一个 P a r a m e t e r对象的全部 P r o p e r t y对象
S i z e 长整型 指出 P a r a m e t e r对象的最大大小，单位为字符或字节
Ty p e D a t a Ty p e E n u m 指出 P a r a m e t e r对象的数据类型
Va l u e Va r i a n t 指出赋给 P a r a m e t e r对象的值
E.9 Parameters集合
P a r a m e t e r s集合的方法和属性分别如表 E - 1 6、表 E - 1 7所示。
表 E-16 Parameters集合的方法方 法 返回值类型 说 明
A p p e n d 向 P a r a m e t e r s集合追加一个 P a r a m e t e r对象
D e l e t 从 P a r a m e t e r s集合中删除一个 P a r a m e t e r对象
R e f r e s h 更新 P a r a m e t e r s集合中的 P a r a m e t e r对象表 E-17 Parameters集合的属性属 性 返回值类型 说 明
C o u n t 长整型 指出 P a r a m e t e r s集合中 P a r a m e t e r对象的数目，只读
I t e m P a r a m e t e r 允许索引到 P a r a m e t e r s集合内，引用一个指定的 P a r a m e t e r对象，只读
E.10 Properties集合
P r o p e r t i e s集合的方法和属性分别如表 E - 1 8、表 E - 1 9所示。
表 E-18 Properties集合的方法方 法 返回值类型 说 明
R e f r e s h 用提供者提供的细节更新 P r o p e r t i e s集合中的 P r o p e r t y对象表 E-19 Properties集合的属性属 性 返回值类型 说 明
C o u n t 长整型 指出 P r o p e r t i e s集合中 P r o p e r t y对象的数目，只读
I t e m P r o p e r t y 允许索引到 P r o p e r t i e s集合内，引用一个指定的 P r o p e r t y对象附录 E ADO 2.5 对象模型 计计 897下载
E,11 Property对象
P r o p e r t y对象的属性如表 E - 2 0所示。
表 E-20 Property对象的属性属 性 返回值类型 说 明
Attributes 长整型 指出 P r o p e r t y对象的特性个数
Name 字符串型 指出 P r o p e r t y对象的名称，只读
Type D a t a Ty p e E n u m 指出 P r o p e r t y对象的数据类型
Value Va r i a n t 指出赋给 P r o p e r t y对象的值
E.12 Record对象
R e c o r d对象的方法和属性分别如表 E - 2 1、表 E - 2 2所示。
表 E-21 Record对象的方法方 法 返回值类型 说 明
C a n c e l 撤消执行一个并步的 E x e c u t e或 O p e n操作
Close 关闭打开的记录
C o p y R e c o rd 字符串型 从一个位置复制一个文件、目录和 R e c o r d代表的对象到另一个位置
D e l e t e R e c o rd 删除一个文件、目录和 R e c o r d代表的对象
G e t C h i l d ren Recordset 返回一个记录集，包含 R e c o r d代表的目录下的文件和文件夹
M o v e R e c o rd 字符串型 从一个位置移动一个文件、目录和 R e c o r d代表的对象到另一个位置
Open 创建一个新的或打开一个现有的文件或目录表 E-22 Record对象的属性属 性 返回值类型 说 明
A c t i v e C o n n e c t i o n Va r i a n t 指出指定的 R e c o r d s e t对象当前属于哪个 C o n n e c t i o n对象
Fields F i e l d s 包含当前 R e c o r d s e t对象中的所有 F i e l d对象，只读
Mode C o n n e c t M o d e E n u m 指出修改 C o n n e c t i o n对象中数据的权限
P a rentURL 字符串型 指出当前 Record 对象的父 Record 对象的绝对 U R L，只读
P ro p e rt i e s P r o p e r t i e s 包含当前 R e c o r d s e t对象中的所有 P r o p r e t y对象，只读
R e c o rd Type R e c o r d Ty p e E n u m 指出 Record 对象是简单记录、结构化文档还是一个集合，
只读
S o u rce Va r i a n t 指出 Record 对象代表的是 U R L，还是到一个打开的记录集的引用
State O b j e c t S t a t e E n u m 指出记录是打开的还是关闭的，如果打开，显示异步活动的状态。只读
E.13 Recordset对象
R e c o r d s e t对象的方法和属性说明分别如表 E - 2 3、表 E - 2 4所示，其事件如表 E - 2 5所示。
898计计 ASP 3 高级编程 下载表 E-23 Recordset对象的方法方 法 返回值类型 说 明
Addnew 为可更新的 R e c o r d s e t对象创建一个新记录
Cancel 撤消执行一个异步的 E x e c u t e或 O p e n操作
C a n c e l B a t c h 撤消批更新
CancelUpdate 撤消对现在记录的任何改变
Clone Recordset 创建现有的 R e c o r d s e t对象的副本 Recordset 对象
Close 关闭 R e c o r d s e t对象及相关的任何对象
CompareBookmarks C o m p a r e E n u m 比较两个书签并返回一个相对值的指示
Deleate 删除当前记录或一组记录
Find 在记录集里寻找匹配给定标准的记录
GetRows Va r i a n t 将 R e c o r d s e t对象中的多个记录检索到一个数组中
GetString 字符串型 作为字符串返回一个 R e c o r d s e t
Move 移动记录集指针指向一个记录
M o v e F r i s t 移动记录集指针指向 R e c o r d s e t中的第一个记录
M o v e L a s t 移动记录集指针指向 Recordset 中的的最后一个记录
MoveNext 移动记录集指针指向 R e c o r d s e t中的下一个记录
M o v e P r e v i o u s 移动记录集指针指向 R e c o r d s e t中的前一个记录
NextRecordset R e c o r d s e t 清除当前的 R e c o r d s e t并用一组命令返回下一个 R e c o r d s e t
O p e n 打开一个 R e c o r d s e t
R e q u e r y 通过重新执行此对象所基于的查询，对 R e c o r d s e t对象的数据进行更新
R e s y n c 根据底层数据库刷新当前 R e c o r d s e t对象的数据
Save 将 R e c o r d s e t保存为一个文件
Seek 搜索记录集索引，查找一个值
Supports 布尔型 决定指定的 R e c o r d s e t对象是否支持某一功能
U p d a t e 保存对当前 R e c o r d s e t对象所做的所有改变
U p d a t e B a t c h 将所有的批更新写到磁盘表 E-24 Recordset对象的属性属 性 返回值类型 说 明
AbsolutePage P o s i t i o n E n u m 指定当前记录在哪一页上
A b s o l u t e P o s i t i o n P o s i t i o n E n u m 指定一个 R e c o r d s e t对象的当前记录的原始位置
ActiveCommand Object 指出创建相关 R e c o r d s e t对象的 C o m m a n d对象，只读
A c t i v e C o n n e c t i o n Va r i a n t 指出指定的 R e c o r d s e t对象当前属于哪个 C o n n e c t i o n对象
B O F 布尔型 指出当前的记录是否在 R e c o r d s e t对象的第一个记录之前，
只读
Bookmark Variant 返回一个在一个 R e c o r d s e t里唯一识别当前记录的书签，
或者把当前的记录设置为用一个有效的书签标识的记录
C a c h e S i z e 长整型 指出在内存中缓存的 R e c o r d s e t对象的记录数
C u r s o r L o c a t i o n C u r s o r Ty p e E n u m 设置或返回光标引擎的位置
C u r s o r Ty p e C u r s o r L o c a t i o n E n u m 指出 R e c o r d s e t对象中使用的光标类型
D a t a M e m b e r 字符串型 指定从由 D a t a S o u r c e属性引用的对象检索的数据成员的名称，只写
D a t a S o u r c e 对象 指定一个对象，它包含的数据由一个 R e c o r d s e t对象，只写
EditMode E d i t M o d e E n u m 指出当前记录的编辑状态，只读
E O F 布尔型 指出当前记录是否在 R e c o r d s e t对象的最后一个记录之后，
只读附录 E ADO 2.5 对象模型 计计 899下载
(续 )
属 性 返回值类型 说 明
Fields F i e l d s 包含当前的 R e c o r d s e t对象中的所有 F i e l d对象
F i l t e r Va r a n t 指出 Recordset 中的数据过滤器
In d e x 字符串型 当前所使用的索引的名称
L o c k Type L o c k Ty p e E n u m 指出编辑过程中放置在记录上的锁的类型
M a r s h a l O p t i o n s M a r s h a l O p t i o n s E n u m 指出哪些记录被调度回服务器
MaxRecords 长整型 指出从一次查询中返回到一个 R e c o r d s e t对象的最大记录数目，默认是零（无限制）
PageCount 长整型 指出 R e c o r d s e t对象包含多少页面，只读
P a g e S i z e 长整型 指出 R e c o r d s e t对象中每页由多少记录组成
Properties P r o p e r t i e s 包含当前的 R e c o r d s e t对象的所有 P r o p e r t y对象
R e c o r d C o u n t 长整型 指出当前的 R e c o r d s e t对象中有多少记录，只读
Sort 字符串型 指定 R e c o r d s e t对象用于排序的一个或多个字段名，并指定排序方向
Source 字符串型 指出 R e c o r d s e t对象的数据源
State 长整型 指出记录集是打开的还是关闭的，或者是否正在执行异步操作，只读
Status 整型 指出当前记录的有关更新或其他批操作的状态，只读
S t a y I n S y n c 布尔型 在一个分层 R e c o r d s e t对象里，指出当下级记录改变时上一级记录是否应该改变，只读表 E-25 Recordset对象的事件事 件 说 明
E n d O f R e c o r d s e t 当试图从 R e c o r d s e t对象的末尾移到下一行时触发
F e t c h C o m p l e t e 当在一个异步操作里所有的记录检索到 R e c o r d s e t对象后触发
F e t c h P r o g r e s s 在较长的异步操作期间内定期地触发，并且报告目前已经检索到的行数
F i e l d C h a n g e C o m p l e t e 当一个或几个字段的值改变完成后触发
M o v e C o m p l e t e R e c o r d s e t对象里的指针位置改变后触发
R e c o r d C h a n g e C o m p l e t e 一个或多个记录改变完成后触发
R e c o r d s e t C h a n g e C o m p l e t e R e c o r d s e t对象改变完成后触发
Wi l l C h a n g e F i e l d 在一个操作将要改变一个或多个字段的值之前触发
Wi l lCh a n g e R e c o r d 当 R e c o r d s e t对象里一行或多行改变前触发
Wi l l C h a n g e R e c o r d s e t 在一个操作改变 R e c o r d s e t对象前触发
WillMove 在一个操作改变 R e c o r d s e t对象里的指针位置前触发
E.14 Stream对象
S t r e a m对象的方法和属性分别如表 E - 2 6、表 E - 2 7所示。
表 E-26 Stream对象的方法方 法 返回值类型 说 明
C a n c l e 撤消一个未完成的异步 O p e n操作
C l o s e 关闭一个打开的 S t r e a m
C o p y To 从一个 S t r e a m到另一个 S t r e a m复制字符或字节
Flush 刷新 S t r e a m的内容到一个底层对象
L o a d F ro m F i l e 从一个文件里读取一个 S t r e a m
900计计 ASP 3 高级编程 下载
(续 )
方 法 返回值类型 说 明
O p e n 从一个存在的 R e c o r d或 U R L里打开一个 S t r e a m对象，或创建一个空的 S t r e a m
R e a d Va r i a n t 从一个 S t r e a m里读取一些字节
R e a d Te x a t 字符串型 从一个文本 S t r e a m里读取一些字符
S a v e To F i l e 存储一个打开的 S t r e a m到一个文件里
SetEOS 把当前的位置设置为 S t r e a m的末尾
S k i p L i n e 当从一个文本 S t r e a m里读取时跳过一行
Wr i t e 把二进制数据写进一个 S t r e a m里
Wr i t e Te x t 把文本数据写进一个 S t r e a m里表 E-27 Stream对象的属性属 性 返回值类型 说 明
c h a r s e t 字符串型 标识用于 S t r e a m的字符集
E O S 布尔型 如果当前的位置是 S t r e a m的末尾，设置为 Tr u e，只读
L i n e S e p a r a t o r L i n e S e p a r a t o r E n u m 指出文本 S t r e a m里用来分隔行的字符，默认是 V b C r L f
Mode C o n n e c t i o n M o d e E n u m 指出修改 C o n n e c t i o n里数据的可用的权限
P o s i t i o n 长整型 指定当前在 S t r e a m中的位置
S i z e 长整型 用字节指出 S t r e a m的长度，只读
S t a t e O b j e c t S t a t e E n u m 指出 S t r e a m是打开的还是关闭的，如果是打开的，指出异步活动的状态，只读
Ty p e S t r e a m Ty p e E n u m 指出 S t r e a m是包含文本还是包含二进制数据附录 E ADO 2.5 对象模型 计计 901下载
