ia°bub.com 下载 附录EADO2.5对象模型 2.5版本中新增的属性和方法用斜体列出。除非声明,否则所有属性都是读/写属性。 E.1ADO对象 ADO对象的名称及说明如表E-1所示 表E1ADO对象的名称及说明 Command对象是指定命令的一个定义,可使用该命令执行对数据源的操作 Connection Connection对象表示一个打开的与数据源的连接 Eror对象包含了涉及提供者的简单操作的有关数据访问错误的详细情况 Errors集合包含了涉及提供者的响应单个错误而创建的所有Eror对象 Field对象代表普通的数据类型内的一列数据 Fields Fields集合包含了一个 Recordset对象的所有 Field对象 Parameter Parameter代表一个与基于参数化查询或存储过程的 Command对象有关的参数 arameters Parameters集合包含一个 Command对象的全部 Parameter对象 Properties Properties集合是包含一个对象特定实例的所有的 Property对象 Property Property.对象代表由提供者定义的ADO对象的一个动态特征 Record对象代表在文件系统或Web资源中的一个文件或一个目录,或记录集中的一个记 Recordset Recordset对象代表一个表的全部记录或执行命令的结果。在任何时候, Recordset对象仅 指向全部记录中的一个记录,作为当前记录 Stream Stream对象代表文本或二进制数据的流 E.2 Command对象 Command对象的方法、属性、返回值类型及说明分别如表E-2和表E-3所示。 表E-2 Command对象的方法、返回值类型及说明 返回值类型 取消未完成的 Execute或Open调用的执行 Create Parameter Parameter 创建一个新的 Parameter对象 Execute Recordset 行由 Commandtext属性指定的存储过程、查询或SOL语句 表E3 Command对象的属性、返回值类型及说明 返回值类型 明当前命令所属的 Connection对象 字符串型 包含要对数据提供者发出的命令的文本
下载 附录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 字符串型 包含要对数据提供者发出的命令的文本
894A5p3高装编程 China pul coM 下载 属性 返回值类型 CommandTimeout 长整型 指明在结束命令并产生错误之前执行命所要等待令的时 间,缺省值为30秒 Command Type Enum 指明 Command对象的类型 字符串型 指明 Command对象的名字 包含 Command对象的所有 Parameter对象 Prepared 布 尔型 指出是否在执行之前保存命令的编译版本 包含 Command对象的所有 Property对象 长整型 描述 Command对象是被打开还是被关闭。只读 E.3 Connection对象 Connection对象的方法、属性和事件分别如表E-4和E-5所示 表E4 Connection对象的方氵 返回值类型 说明 开始一个新事务 Cancel 删除正在异步执行的 ExecutePOpen操作 Close 关闭一个打开的连接和任何相关的对象 CommitTrans 保留任何变化并结束当前的事务 Execute Recordset 执行SQL语句、存储过程、查询或提供者指定的文本 Open 打开一个到数据源的连接,以便命令能对其运行 Recordset 从提供者获得数据库模式信息 Rollback Trans 取消当前事务的所有改变,终止事务 表E5 Connection对象的属性 返回值类型 说明 Attributes 长整型 指出 Connection对象的特性个数,缺省为0 Command Timeout 长整型 指明在结束命令并产生错误之前执行命令所要等待的 时间,缺省值为30秒 Connection String 字符串型 包含用于建立与数据源的连接的信息 Connection Timeout 长整型 指明在结束并产生错误之前建立一个连接所要等待的 时间,缺省值为15秒 Cursorlocation CursorLocation Enum 设置或返回光标引擎的位置 字符串型 指出 Connection对象的缺省数据库 Errors 包含涉及提供者的响应单个错误而创建的所有Eror 对象 Isolati level IsolationLevelEnum 指出用于 Connection对象的事务隔离级别。只写 ConnectMode Enum 指出在 Connection对象中修改数据可用的权限 Properties 包括一个 Connection对象的全部 Property对象 符串型 指出 Connection对象的提供者 长整型 指出 Connection对象是打开还是关闭的。只读 Version 符串型 指出ADO的版本号。只读
(续) 属 性 返回值类型 说 明 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 高级编程 下载
4D05对象895 表E6 Connection对象的事件 说明 在 Begintran操作结束后触发 CommitTrans Complate 在 Committrans操作结束后触发 ConnectComplete 接开始后触发 Disconnect 在连接结束后触发 在命令执行结束后触发 InfoMessage 只要成功地完成 Connection event操作并且提供者返回了附加的信息, 可以触发 在 Rollbacktrans操作结束后触发 WillConnect 在连接开始前触发 WillExecute 在一个连接上执行命令之前触发 E.4 Error对象 Eror对象的属性如表E-7所示。 表E7 Error对象的属性 属性 区回值类型 字符型 个与错误相关的描述字符串,只读 elpContext 指出与错误相关的帮助文件的 ContextEd,只读 HelpFile 李铝型 指出帮助文件的名字,只读 指出与错误相关的提供者指定的错误代码,只读 Number 长整型 指出唯一识别Eror对象的数字,只读 字符串型 指出产生的错误的应用程序或对象的名称 SQLState 字符串型 指出给定Ero对象的SQL状态,这是符合 ANSI SQL标准 的5个字符的字符串,只读 E.5 Errors集合 Errors集合的方法和属性分别如表E-8、表E-9所示。 表E8 Errors集合的方法 返回值类型 从 Errors集合中清除所有的Eror对象 用提供者提供的信息更新Eror对象,只读 表E9 Errors集合的属性 返回值类型 长整型 指出 Errors集合中Eror对象的数目,只读 允许索引到 Errors集合内,引用一个指定的Eror对象,只读 E.6 Field对象 Field对象的方法和属性分别如表E-10、表E-11所示
表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 下载
896A5p3高装程 Chinapub.com 下载 表E-10Fed对象的方法 返回值类型 附加数据给大型的或者二进制的Feld对象 GetChunk Variant 返回一个大型的或者二进制的Fed对象的所有或部分内容 表E-11 Field对象的属性 返回值类型 ActualSize 长整型 指出字段值的实际长度,只读 Attributes 长整型 指出一个Fied对象的属性个数 Data Format 指出要求的数据显示格式 Definedsize 长整型 指出Feld对象定义的大小,只写 Name 字符串型 指出Fied对象的名称 NumericScale 字节型 指出Feld对象的数值范围,只写 Original value 指出在变化前存在于记录中的 Field对象的值,只读 字节型 指出Feld对象的数值精度,只读 包含一个 Field对象的全部 Property对象,只读 指出 Field对象的数据类型 Underlying value Variant 指出一个 Field对象在数据库中的当前值,只读 Variant 指出赋给 Field对象的值 E7 Fields集合 Fields集合的方法和属性分别如表E-12、表E-13所示 表E-12Feds集合的方法 返回值类型 向 Fields集合追加一个Fied对象 CancelUpdate 撤消对 Fields集合做的任何改动 从 Fields集合中删除一个 Field对象 Refresh 更新 Fields集合中的 Field对象 重新同步 Fields集合中的数据 存储对 Fields集合所做的改变 表E-13Feds集合的属性 返回值类型 长整型 指出 Fields集合中Fied对象的数目,只读 Item 允许索引到 Fields集合内,引用一个指定的 Field对象,只读 E8 Parameter对象 Parameter对象的方法和属性分别如表E-14、表E-15所示
表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 高级编程 下载
Chinapub.com 是4D25对象897 下载 表E14 Parameter对象的方法 返回值类型 Append Chunk 向大型的或者二进制的 Parameter对象追加数据 表E-15 Parameter对象的属性 返回值类型 Attributes 长整型 指出 Parameter对象的特性个数 Direction Parameter Direction Enum指出 Parameter对象是输入参数、输出参数或双向参数,参数 是否从存储过程中返回值 Name 字符串型 指出 Parameter对象的名称 NumericScale 字节型 指出 Parameter对象的数值范围 字节型 指出 Parameter对象的数值精度 Properties Properties 包含一个 Parameter对象的全部 Property对象 长整型 指出 Parameter对象的最大大小,单位为字符或字节 DataType Enum 指出 Parameter对象的数据类型 Variant 指出赋给 Parameter对象的值 E9 Parameters集合 Parameters集合的方法和属性分别如表E-16、表E-17所示 表E-16 Parameters集合的方法 返回值类型 向 Parameters集合追加一个 Paramete对象 从 Parameters集合中删除一个 Parameter对象 Refresh 更新 Parameters集合中的 Parameter对象 表E-17 Parameters集合的属性 返回值类型 Count 长整型 指出 Parameters集合中 Parameter对象的数目,只读 允许索引到 Parameters集合内,引用一个指定的 Parameter对象,只读 E.10 Properties集合 Properties集合的方法和属性分别如表E-18、表E-19所示 表E-18 Properties:集合的方法 返回值类型 Refresh 用提供者提供的细节更新 Properties集合中的 Property.对象 表E-19 Properties集合的属性 属性 返回值类型 Count 长整型 指出 Properties集合中 Property对象的数目,只读 Item 允许索引到 Properties集合内,引用一个指定的 Property对象
表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 下载
898A5p3高装编程 Chinapub.com 下载 E.11 Property对象 Property对象的属性如表E-20所示 表E20 Property对象的属性 返回值类型 Attributes 长整型 指出 Property对象的特性个数 字符串型 Type Data Enum 指出 Property对象的数据类型 Value Variant 指出赋给 Property对象的值 E.12 Record对象 Record对象的方法和属性分别如表E-21、表E22所示。 表E21 Record对象的方法 返回值类型 撤消执行一个并步的 Execute或Open操作 关闭打开的记录 CopyRecord 字符串型 从一个位置复制一个文件、目录和 Record代表的对象到另一个位置 Delete record 删除一个文件、目录和 Record代表的对象 GetChildren Recordset 返回一个记录集,包含 Record代表的目录下的文件和文件夹 Move record 字符串型 从一个位置移动一个文件、目录和 Record代表的对象到另一个位置 创建一个新的或打开一个现有的文件或目录 表E-22 Record对象的属性 返回值类型 说明 Active Connection 指出指定的 Recordset对象当前属于哪个 Connection对象 Fields 包含当前 Recordset对象中的所有Feld对象,只读 指出修改 Connection对象中数据的权限 字符串型 指出当前 Record对象的父 Record对象的绝对URL,只读 Properties 包含当前 Recordset对象中的所有 Proprety对象,只读 RecordType Enum 指出 Record对象是简单记录、结构化文档还是一个集合, 只读 Variant 指出 Record对象代表的是URL,还是到一个打开的记录 集的引用 ObjectState Enum 指出记录是打开的还是关闭的,如果打开,显示异步活 动的状态。只读 E.13 Recordset对象 Recordset对象的方法和属性说明分别如表E-23、表E-24所示,其事件如表E-25所示
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 高级编程 下载
4D05对象899 表E-23 Recordset.对象的方法 返回值类型 Addnew 为可更新的 Recordset对象创建一个新记录 撤消执行一个异步的 Execute或Open操作 Cancel 撤消批更新 撤消对现在记录的任何改变 创建现有的 Recordset对象的副本 Recordset对象 Close 关闭 Recordset对象及相关的任何对象 Compare Bookmarks Compare Enum比较两个书签并返回一个相对值的指示 Delate 删除当前记录或一组记录 Find 在记录集里寻找匹配给定标准的记录 GetRows Variant 将 Recordset对象中的多个记录检索到一个数组中 符串型 作为字符串返回一个 Recordset Move 移动记录集指针指向一个记录 Move Frist 移动记录集指针指向 Recordset中的第一个记录 Movelast 移动记录集指针指向 Recordset中的的最后一个记录 Move Next 移动记录集指针指向 Recordset I中的下一个记录 Move Previous 移动记录集指针指向 Records中的前一个记录 NextRecordset 清除当前的 Recordset并用一组命令返回下一个 Recordset 打开一个 Recordset 通过重新执行此对象所基于的查询,对 Recordset对象的数据进行更新 Resync 根据底层数据库刷新当前 Recordset对象的数据 Save 将 Recordset保存为一个文件 搜索记录集索引,查找一个值 Supports 布尔型 决定指定的 Recordset对象是否支持某一功能 Update 保存对当前 Records对象所做的所有改变 Update Batch 将所有的批更新写到磁盘 表E-24 Recordset对象的属性 返回值类型 AbsolutePage Position enum 指定当前记录在哪一页上 指定一个 Recordset对象的当前记录的原始位置 Object 指出创建相关 Recordset对象的 Command对象,只读 ActiveConnection 指出指定的 Recordset对象当前属于哪个 Connection对象 布尔型 指出当前的记录是否在 Recordset对象的第一个记录之前, Bookmark Variant 返回一个在一个 Recordset里唯一识别当前记录的书签, 或者把当前的记录设置为用一个有效的书签标识的记录 CacheSize 长整型 指出在内存中缓存的 Recordset对象的记录数 Cursorlocation 设置或返回光标引擎的位置 CursorLocation Enum指出 Recordset对象中使用的光标类型 DataMember 字符串型 指定从由 DataSource属性引用的对象检索的数据成员的 名称,只写 Data Source 对象 指定一个对象,它包含的数据由一个 Recordset对象,只 EditMode EditMode Enum 指出当前记录的编辑状态,只读 布尔型 指出当前记录是否在 Recordset对象的最后一个记录之后
表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 下载
900Ap高程 Cha°deoN 下载 属性 返回值类型 Fields Fields 包含当前的 Recordset对象中的所有Feld对象 指出 Recordset中的数据过滤器 字符串型 当前所使用的索引的名称 ock Type Lock Type Enum 指出编辑过程中放置在记录上的锁的类型 指出哪些记录被调度回服务器 MaxRecords 长整型 指出从一次查询中返回到一个 Recordset对象的最大记录 数目,默认是零(无限制) 长整型 指出 Recordset对象包含多少页面,只读 PageSize 长整型 指出 Recordset对象中每页由多少记录组成 Properti 包含当前的 Recordset对象的所有 Property.对象 RecordCount 长整型 指出当前的 Recordset对象中有多少记录,只读 字符串型 指定 Recordset对象用于排序的一个或多个字段名,并 指定排序方向 Source 字符串型 指出 Recordset对象的数据源 长整型 指出记录集是打开的还是关闭的,或者是否正在执行异 步操作,只读 Status 整型 指出当前记录的有关更新或其他批操作的状态,只读 StaylnSyne 布尔型 在一个分层 Recordset对象里,指出当下级记录改变时上 级记录是否应该改变,只读 表E25 Recordset对象的事件 事件 EndofRecordset 当试图从 Records对象的末尾移到下一行时触发 当在一个异步操作里所有的记录检索到 Recordset对象后触发 在较长的异步操作期间内定期地触发,并且报告目前已经检索到的行数 FieldChange Complete 当一个或几个字段的值改变完成后触发 Move Complete Recordset对象里的指针位置改变后触发 Record Change Complete 个或多个记录改变完成后触发 Recordset Change Complete Recordset对象改变完成后触发 WillChange Field 在一个操作将要改变一个或多个字段的值之前触发 当 Recordset对象里一行或多行改变前触发 WillChange Recordset 在一个操作改变 Recordset对象前触发 WillMove 在一个操作改变 Recordset对象里的指针位置前触发 E.14 Stream对象 Stream对象的方法和属性分别如表E-26、表E-27所示 表E26 Stream对象的方法 方法 返回值类型 Cancle 撤消一个未完成的异步Open操作 Close 关闭一个打开的 Stream CopyTo 从一个 Stream到另一个 Stream复制字符或字节 刷新 Stream的内容到一个底层对象 LoadFrom File 从一个文件里读取一个 Stream
(续) 属 性 返回值类型 说 明 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 高级编程 下载
Chinapub.com 4D05对象型901 下载 方法 返回值类型 从一个存在的 Record或URL里打开一个 Stream对象,或创建一个 Variant 从一个 Strean里读取一些字节 ReadEr 字符串型 从一个文本 Stream里读取一些字符 SaveToFile 存储一个打开的 Stream到一个文件里 SeteOS 把当前的位置设置为 Strean的末尾 Skipline 当从一个文本 Stream里读取时跳过一行 把二进制数据写进一个 Stream里 Write Text 把文本数据写进一个 Stream里 表E27 Stream对象的属性 属性 返回值类型 标识用于 Stream的字符集 布尔型 如果当前的位置是 Stream的末尾,设置为True,只读 Line separator 指出文本 Stream里用来分隔行的字符,默认是 VbCrlf Connection Mode Enum 指出修改 Connection里数据的可用的权限 Position 长整型 指定当前在 Stream中的位置 长整型 用字节指出 Strea State ObjectState Enum 指出 Stream是打开的还是关闭的,如果是打开的,指 出异步活动的状态,只读 Stream Type Enum 指出 Stream是包含文本还是包含二进制数据
(续) 方 法 返回值类型 说 明 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 下载