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 下载