ADO参考手册.docx

1、ADO参考手册Recordset 对象ADO Recordset 对象用于容纳一个来自数据库表的记录集。一个 Recordset 对象由记录和列（字段）组成。在 ADO 中，此对象是最重要且最常用于对数据库的数据进行操作的对象。ProgIDset objRecordset=Server.CreateObject(ADODB.recordset) 当您首次打开一个 Recordset 时，当前记录指针将指向第一个记录，同时 BOF 和 EOF 属性为 False。如果没有记录，BOF 和 EOF 属性为 True。Recordset 对象能够支持两种更新类型：立即更新 - 一旦调用 Update

2、 方法，所有更改被立即写入数据库。批更新 - provider 将缓存多个更改，然后使用 UpdateBatch 方法把这些更改传送到数据库。 在 ADO，定义了 4 中不同的游标（指针）类型： 动态游标 - 允许您查看其他用户所作的添加、更改和删除 键集游标 - 类似动态游标，不同的是您无法查看有其他用户所做的添加，并且它会防止您访问其他用户已删除的记录。其他用户所做的数据更改仍然是可见的。 静态游标 - 提供记录集的静态副本，可用来查找数据或生成报告。此外，由其他用户所做的添加、更改和删除将是不可见的。当您打开一个客户端 Recordset 对象时，这是唯一被允许的游标类型。 仅向前游标

3、- 只允许在 Recordset 中向前滚动。此外，由其他用户所做的添加、更改和删除将是不可见的。 可通过 CursorType 属性或 Open 方法中的 CursorType 参数来设置游标的类型。注释：并非所有的提供者（providers）支持 Recordset 对象的所有方法和属性。属性属性描述AbsolutePage设置或返回一个可指定 Recordset 对象中页码的值。AbsolutePosition设置或返回一个值，此值可指定 Recordset 对象中当前记录的顺序位置（序号位置）。ActiveCommand返回与 Recordset 对象相关联的 Command 对象。A

4、ctiveConnection如果连接被关闭，设置或返回连接的定义，如果连接打开，设置或返回当前的 Connection 对象。BOF如果当前的记录位置在第一条记录之前，则返回 true，否则返回 fasle。Bookmark设置或返回一个书签。此书签保存当前记录的位置。CacheSize设置或返回能够被缓存的记录的数目。CursorLocation设置或返回游标服务的位置。CursorType设置或返回一个 Recordset 对象的游标类型。DataMember设置或返回要从 DataSource 属性所引用的对象中检索的数据成员的名称。DataSource指定一个包含要被表示为 Reco

5、rdset 对象的数据的对象。EditMode返回当前记录的编辑状态。EOF如果当前记录的位置在最后的记录之后，则返回 true，否则返回 fasle。Filter返回一个针对 Recordset 对象中数据的过滤器。Index设置或返回 Recordset 对象的当前索引的名称。LockType设置或返回当编辑 Recordset 中的一条记录时，可指定锁定类型的值。MarshalOptions设置或返回一个值，此值指定哪些记录被返回服务器。MaxRecords设置或返回从一个查询返回 Recordset 对象的的最大记录数目。PageCount返回一个 Recordset 对象中的数据页数

6、。PageSize设置或返回 Recordset 对象的一个单一页面上所允许的最大记录数。RecordCount返回一个 Recordset 对象中的记录数目。Sort设置或返回一个或多个作为 Recordset 排序基准的字段名。Source设置一个字符串值，或一个 Command 对象引用，或返回一个字符串值，此值可指示 Recordset 对象的数据源。State返回一个值，此值可描述是否 Recordset 对象是打开、关闭、正在连接、正在执行或正在取回数据。Status返回有关批更新或其他大量操作的当前记录的状态。StayInSync设置或返回当父记录位置改变时对子记录的引用是否改变

7、。方法方法描述AddNew创建一条新记录。Cancel撤销一次执行。CancelBatch撤销一次批更新。CancelUpdate撤销对 Recordset 对象的一条记录所做的更改。Clone创建一个已有 Recordset 的副本。Close关闭一个 Recordset。CompareBookmarks比较两个书签。Delete删除一条记录或一组记录。Find搜索一个 Recordset 中满足指定某个条件的一条记录。GetRows把多条记录从一个 Recordset 对象中拷贝到一个二维数组中。GetString将 Recordset 作为字符串返回。Move在 Recordset 对象

8、中移动记录指针。MoveFirst把记录指针移动到第一条记录。MoveLast把记录指针移动到最后一条记录。MoveNext把记录指针移动到下一条记录。MovePrevious 把记录指针移动到上一条记录。 NextRecordset通过执行一系列命令清除当前 Recordset 对象并返回下一个 Recordset。Open打开一个数据库元素，此元素可提供对表的记录、查询的结果或保存的 Recordset 的访问。Requery通过重新执行对象所基于的查询来更新 Recordset 对象中的数据。Resync从原始数据库刷新当前 Recordset 中的数据。Save把 Recordset

9、对象保存到 file 或 Stream 对象中。Seek搜索 Recordset 的索引以快速定位与指定的值相匹配的行，并使其成为当前行。Supports返回一个布尔值，此值可定义 Recordset 对象是否支持特定类型的功能。Update保存所有对 Recordset 对象中的一条单一记录所做的更改。UpdateBatch把所有 Recordset 中的更改存入数据库。请在批更新模式中使用。事件Note: You cannot handle events using VBScript or JScript (only Visual Basic, Visual C+, and Visual

10、J+ languages can handle events).事件描述EndOfRecordset当试图移动到超过 Recordset 结尾的行时被触发。FetchComplete当异步操作中的所有记录均被读取后被触发。FetchProgress在异步操作期间被定期地触发，报告已读取多少记录。FieldChangeCompleteField 对象的值更改被触发。MoveCompleteRecordset 中的当前位置更改后被触发。RecordChangeComplete一条记录更改之后被触发。RecordsetChangeComplete在 Recordset 更改之后被触发。WillCha

11、ngeField在 Field 对象的值更改之前被触发WillChangeRecord在一条记录更改之前被触发。WillChangeRecordset在 Recordset 更改之前被触发。WillMove在 Recordset 中的当前位置更改之前被触发。集合集合描述Fields指示在此 Recordset 对象中 Field 对象的数目。Properties包含所有 Recordset 对象中的 Property 对象。Fields 集合的属性属性描述Count返回 fields 集合中项目的数目。以 0 起始。例子：countfields = rs.Fields.CountItem(na

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

13、rties.Item(Name)Stream 对象 (ADO version 2.5)ADO Stream 对象用于读写以及处理二进制数据或文本流。Stream 对象可通过三种方法获得： 通过指向包含二进制或文本数据的对象（通常是文件）的 URL。此对象可以是简单的文档、表示结构化文档的 Record 对象或文件夹。 通过将 Stream 对象实例化。这些 Stream 对象可用来存储用于应用程序的数据。跟与 URL 相关联的 Stream 或 Record 的默认 Stream 不同，实例化的 Stream 在默认情况下与基本源没有关联。 通过打开与 Record 对象相关联的默认 Stre

14、am 对象。打开 Record 时便可获取与 Record 对象相关联的默认流。只需打开该流便可删除一个往返过程。 语法objectname.propertyobjectname.method属性属性描述CharSet指定用于存储 Stream 的字符集。EOS返回当前位置是否位于流的结尾。LineSeparator设置或返回用在文本 Stream 对象中的分行符。Mode设置或返回供修改数据的可用权限。Position设置或返回从 Stream 对象开始处的当前位置（按字节计算）。Size返回一个打开的 Stream 对象的大小。State返回一个描述 Stream 是打开还是关闭的值。Ty

15、pe设置或返回 Stream 对象中的数据的类型。方法方法描述Cancel取消对 Stream 对象的 Open 调用的执行。Close关闭一个 Stream 对象。CopyTo把指定数目的字符/比特从一个 Stream 对象拷贝到另外一个 Stream 对象。Flush把 Stream 缓冲区中的内容发送到相关联的下层对象。LoadFromFile把文件的内容载入 Stream 对象。Open打开一个 Stream 对象。Read从一个二进制 Stream 对象读取全部流或指定的字节数。ReadText从一个文本 Stream 对象中读取全部流、一行或指定的字节数。SaveToFile把一个

16、 Stream 对象的二进制内容保存到某个文件。SetEOS设置当前位置为流的结尾 (EOS)SkipLine在读取一个文本流时跳过一行。Write把二进制数据写到一个二进制 Stream 对象。WriteText把字符数据写到一个文本 Stream 对象。下面的表格列出了 Access、SQL Server 与 Oracle 之间的数据类型映射：DataType EnumValueAccessSQLServerOracleadBigInt20BigInt (SQL Server 2000 +)adBinary128BinaryTimeStampRaw *adBoolean11YesNoBit

17、adChar129CharCharadCurrency6CurrencyMoneySmallMoneyadDate7DateDateTimeadDBTimeStamp135DateTime (Access 97 (ODBC)DateTimeSmallDateTimeDateadDecimal14Decimal *adDouble5DoubleFloatFloatadGUID72ReplicationID (Access 97 (OLEDB), (Access 2000 (OLEDB)UniqueIdentifier (SQL Server 7.0 +)adIDispatch9adInteger

18、3AutoNumberIntegerLongIdentity (SQL Server 6.5)IntInt *adLongVarBinary205OLEObjectImageLong Raw *Blob (Oracle 8.1.x)adLongVarChar201Memo (Access 97)Hyperlink (Access 97)TextLong *Clob (Oracle 8.1.x)adLongVarWChar203Memo (Access 2000 (OLEDB)Hyperlink (Access 2000 (OLEDB)NText (SQL Server 7.0 +)NClob

19、(Oracle 8.1.x)adNumeric131Decimal (Access 2000 (OLEDB)DecimalNumericDecimalIntegerNumberSmallIntadSingle4SingleRealadSmallInt2IntegerSmallIntadUnsignedTinyInt17ByteTinyIntadVarBinary204ReplicationID (Access 97)VarBinaryadVarChar200Text (Access 97)VarCharVarCharadVariant12Sql_Variant (SQL Server 2000

20、 +)VarChar2adVarWChar202Text (Access 2000 (OLEDB)NVarChar (SQL Server 7.0 +)NVarChar2adWChar130NChar (SQL Server 7.0 +)* 在 Oracle 8.0.x 中 - decimal 和 int 等于 number 和 number(10)。Command 对象ADO Command 对象用于执行面向数据库的一次简单查询。此查询可执行诸如创建、添加、取回、删除或更新记录等动作。如果该查询用于取回数据，此数据将以一个 RecordSet 对象返回。这意味着被取回的数据能够被 Recor

21、dSet 对象的属性、集合、方法或事件进行操作。Command 对象的主要特性是有能力使用存储查询和带有参数的存储过程。ProgIDset objCommand=Server.CreateObject(ADODB.command)属性属性描述ActiveConnection设置或返回包含了定义连接或 Connection 对象的字符串。CommandText设置或返回包含提供者（provider）命令（如 SOL 语句、表格名称或存储的过程调用）的字符串值。默认值为 （零长度字符串）。CommandTimeout设置或返回长整型值，该值指示等待命令执行的时间（单位为秒）。默认值为 30。Com

22、mandType设置或返回一个 Command 对象的类型Name设置或返回一个 Command 对象的名称Prepared指示执行前是否保存命令的编译版本（已经准备好的版本）。State返回一个值，此值可描述该 Command 对象处于打开、关闭、连接、执行还是取回数据的状态。方法方法描述Cancel取消一个方法的一次执行。CreateParameter创建一个新的 Parameter 对象Execute执行 CommandText 属性中的查询、SQL 语句或存储过程。集合集合描述Parameters包含一个 Command 对象的所有 Parameter 对象。Properties包含一

23、个 Command 对象的所有 Property 对象。Connection 对象ADO Connection 对象用于创建一个到达某个数据源的开放连接。通过此连接，您可以对一个数据库进行访问和操作。如果需要多次访问某个数据库，您应当使用 Connection 对象来建立一个连接。您也可以经由一个 Command 或 Recordset 对象传递一个连接字符串来创建某个连接。不过，此类连接仅仅适合一次具体的简单的查询。ProgIDset objConnection=Server.CreateObject(ADODB.connection)属性属性描述Attributes设置或返回 Connec

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

25、描述连接是打开还是关闭的值。Version返回 ADO 的版本号。方法方法描述BeginTrans开始一个新事务。Cancel取消一次执行。Close关闭一个连接。CommitTrans保存任何更改并结束当前事务。Execute执行查询、SQL 语句、存储过程或 provider 具体文本。Open打开一个连接。OpenSchema从 provider 返回有关数据源的 schema 信息。RollbackTrans取消当前事务中所作的任何更改并结束事务。事件注释：您无法使用 VBScript or JScript 来处理事件（仅能使用 Visual Basic、Visual C+ 以及 Vi

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

27、llExecute在一条命令被执行之前被触发。集合集合描述Errors包含 Connection 对象的所有 Error 对象。Properties包含 Connection 对象的所有 Property 对象。Error 对象ADO Error 对象包含与单个操作（涉及提供者）有关的数据访问错误的详细信息。ADO 会因每次错误产生一个 Error 对象。每个 Error 对象包含具体错误的详细信息，且 Error 对象被存储在 Errors 集合中。要访问这些错误，就必须引用某个具体的连接。循环遍历 Errors 集合：%for each objErr in objConn.Errors r

28、esponse.write() response.write(Description: ) response.write(objErr.Description & ) response.write(Help context: ) response.write(objErr.HelpContext & ) response.write(Help file: ) response.write(objErr.HelpFile & ) response.write(Native error: ) response.write(objErr.NativeError & ) response.write(

29、Error number: ) response.write(objErr.Number & ) response.write(Error source: ) response.write(objErr.Source & ) response.write(SQL state: ) response.write(objErr.SQLState & ) response.write()next%语法objErr.property属性属性描述Description返回一个错误描述。HelpContext返回 Microsoft Windows help system 中某个主题的内容 ID。HelpFile返回