ADO参考手册.docx
《ADO参考手册.docx》由会员分享，可在线阅读，更多相关《ADO参考手册.docx（24页珍藏版）》请在冰点文库上搜索。
ADO参考手册
Recordset对象
ADORecordset对象用于容纳一个来自数据库表的记录集。
一个Recordset对象由记录和列（字段）组成。
在ADO中，此对象是最重要且最常用于对数据库的数据进行操作的对象。
ProgID
setobjRecordset=Server.CreateObject（"ADODB.recordset"）
当您首次打开一个Recordset时，当前记录指针将指向第一个记录，同时BOF和EOF属性为False。
如果没有记录，BOF和EOF属性为True。
Recordset对象能够支持两种更新类型：
立即更新-一旦调用Update方法，所有更改被立即写入数据库。
批更新-provider将缓存多个更改，然后使用UpdateBatch方法把这些更改传送到数据库。
在ADO，定义了4中不同的游标（指针）类型：
∙动态游标-允许您查看其他用户所作的添加、更改和删除
∙键集游标-类似动态游标，不同的是您无法查看有其他用户所做的添加，并且它会防止您访问其他用户已删除的记录。
其他用户所做的数据更改仍然是可见的。
∙静态游标-提供记录集的静态副本，可用来查找数据或生成报告。
此外，由其他用户所做的添加、更改和删除将是不可见的。
当您打开一个客户端Recordset对象时，这是唯一被允许的游标类型。
∙仅向前游标-只允许在Recordset中向前滚动。
此外，由其他用户所做的添加、更改和删除将是不可见的。
可通过CursorType属性或Open方法中的CursorType参数来设置游标的类型。
注释：
并非所有的提供者（providers）支持Recordset对象的所有方法和属性。
属性
属性
描述
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中的更改存入数据库。
请在批更新模式中使用。
事件
Note:
YoucannothandleeventsusingVBScriptorJScript（onlyVisualBasic,VisualC++,andVisualJ++languagescanhandleevents）.
事件
描述
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"）
Properties集合的属性
属性
描述
Count
返回properties集合中项目的数目。
以0起始。
例子：
countprop=rs.Properties.Count
Item（named_item/number）
返回properties集合中某个指定的项目。
例子：
itemprop=rs.Properties.Item
（1）
或者
itemprop=rs.Properties.Item（"Name"）
Stream对象（ADOversion2.5）
ADOStream对象用于读写以及处理二进制数据或文本流。
Stream对象可通过三种方法获得：
∙通过指向包含二进制或文本数据的对象（通常是文件）的URL。
此对象可以是简单的文档、表示结构化文档的Record对象或文件夹。
∙通过将Stream对象实例化。
这些Stream对象可用来存储用于应用程序的数据。
跟与URL相关联的Stream或Record的默认Stream不同，实例化的Stream在默认情况下与基本源没有关联。
∙通过打开与Record对象相关联的默认Stream对象。
打开Record时便可获取与Record对象相关联的默认流。
只需打开该流便可删除一个往返过程。
语法
objectname.property
objectname.method
属性
属性
描述
CharSet
指定用于存储Stream的字符集。
EOS
返回当前位置是否位于流的结尾。
LineSeparator
设置或返回用在文本Stream对象中的分行符。
Mode
设置或返回供修改数据的可用权限。
Position
设置或返回从Stream对象开始处的当前位置（按字节计算）。
Size
返回一个打开的Stream对象的大小。
State
返回一个描述Stream是打开还是关闭的值。
Type
设置或返回Stream对象中的数据的类型。
方法
方法
描述
Cancel
取消对Stream对象的Open调用的执行。
Close
关闭一个Stream对象。
CopyTo
把指定数目的字符/比特从一个Stream对象拷贝到另外一个Stream对象。
Flush
把Stream缓冲区中的内容发送到相关联的下层对象。
LoadFromFile
把文件的内容载入Stream对象。
Open
打开一个Stream对象。
Read
从一个二进制Stream对象读取全部流或指定的字节数。
ReadText
从一个文本Stream对象中读取全部流、一行或指定的字节数。
SaveToFile
把一个Stream对象的二进制内容保存到某个文件。
SetEOS
设置当前位置为流的结尾（EOS）
SkipLine
在读取一个文本流时跳过一行。
Write
把二进制数据写到一个二进制Stream对象。
WriteText
把字符数据写到一个文本Stream对象。
下面的表格列出了Access、SQLServer与Oracle之间的数据类型映射：
DataTypeEnum
Value
Access
SQLServer
Oracle
adBigInt
20
BigInt（SQLServer2000+）
adBinary
128
Binary
TimeStamp
Raw*
adBoolean
11
YesNo
Bit
adChar
129
Char
Char
adCurrency
6
Currency
Money
SmallMoney
adDate
7
Date
DateTime
adDBTimeStamp
135
DateTime（Access97（ODBC））
DateTime
SmallDateTime
Date
adDecimal
14
Decimal*
adDouble
5
Double
Float
Float
adGUID
72
ReplicationID（Access97（OLEDB））,（Access2000（OLEDB））
UniqueIdentifier（SQLServer7.0+）
adIDispatch
9
adInteger
3
AutoNumber
Integer
Long
Identity（SQLServer6.5）
Int
Int*
adLongVarBinary
205
OLEObject
Image
LongRaw*
Blob（Oracle8.1.x）
adLongVarChar
201
Memo（Access97）
Hyperlink（Access97）
Text
Long*
Clob（Oracle8.1.x）
adLongVarWChar
203
Memo（Access2000（OLEDB））
Hyperlink（Access2000（OLEDB））
NText（SQLServer7.0+）
NClob（Oracle8.1.x）
adNumeric
131
Decimal（Access2000（OLEDB））
Decimal
Numeric
Decimal
Integer
Number
SmallInt
adSingle
4
Single
Real
adSmallInt
2
Integer
SmallInt
adUnsignedTinyInt
17
Byte
TinyInt
adVarBinary
204
ReplicationID（Access97）
VarBinary
adVarChar
200
Text（Access97）
VarChar
VarChar
adVariant
12
Sql_Variant（SQLServer2000+）
VarChar2
adVarWChar
202
Text（Access2000（OLEDB））
NVarChar（SQLServer7.0+）
NVarChar2
adWChar
130
NChar（SQLServer7.0+）
*在Oracle8.0.x中-decimal和int等于number和number（10）。
Command对象
ADOCommand对象用于执行面向数据库的一次简单查询。
此查询可执行诸如创建、添加、取回、删除或更新记录等动作。
如果该查询用于取回数据，此数据将以一个RecordSet对象返回。
这意味着被取回的数据能够被RecordSet对象的属性、集合、方法或事件进行操作。
Command对象的主要特性是有能力使用存储查询和带有参数的存储过程。
ProgID
setobjCommand=Server.CreateObject（"ADODB.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对象。
Connection对象
ADOConnection对象用于创建一个到达某个数据源的开放连接。
通过此连接，您可以对一个数据库进行访问和操作。
如果需要多次访问某个数据库，您应当使用Connection对象来建立一个连接。
您也可以经由一个Command或Recordset对象传递一个连接字符串来创建某个连接。
不过，此类连接仅仅适合一次具体的简单的查询。
ProgID
setobjConnection=Server.CreateObject（"ADODB.connection"）
属性
属性
描述
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
取消当前事务中所作的任何更改并结束事务。
事件
注释：
您无法使用VBScriptorJScript来处理事件（仅能使用VisualBasic、VisualC++以及VisualJ++语言处理事件）。
事件
描述
BeginTransComplete
在BeginTrans操作之后被触发。
CommitTransComplete
在CommitTrans操作之后被触发。
ConnectComplete
在一个连接开始后被触发。
Disconnect
在一个连接结束之后被触发。
ExecuteComplete
在一条命令执行完毕后被触发。
InfoMessage
假如在一个ConnectionEvent操作过程中警告发生，则触发该事件。
RollbackTransComplete
在RollbackTrans操作之后被触发。
WillConnect
在一个连接开始之前被触发。
WillExecute
在一条命令被执行之前被触发。
集合
集合
描述
Errors
包含Connection对象的所有Error对象。
Properties
包含Connection对象的所有Property对象。
Error对象
ADOError对象包含与单个操作（涉及提供者）有关的数据访问错误的详细信息。
ADO会因每次错误产生一个Error对象。
每个Error对象包含具体错误的详细信息，且Error对象被存储在Errors集合中。
要访问这些错误，就必须引用某个具体的连接。
循环遍历Errors集合：
<%
foreachobjErrinobjConn.Errors
response.write（"
"）
response.write（"Description:
"）
response.write（objErr.Description&"
"）
response.write（"Helpcontext:
"）
response.write（objErr.HelpContext&"
"）
response.write（"Helpfile:
"）
response.write（objErr.HelpFile&"
"）
response.write（"Nativeerror:
"）
response.write（objErr.NativeError&"
"）
response.write（"Errornumber:
"）
response.write（objErr.Number&"
"）
response.write（"Errorsource:
"）
response.write（objErr.Source&"
"）
response.write（"SQLstate:
"）
response.write（objErr.SQLState&"
"）
response.write（"
"）
next
%>
语法
objErr.property
属性
属性
描述
Description
返回一个错误描述。
HelpContext
返回MicrosoftWindowshelpsystem中某个主题的内容ID。
HelpFile
返回MicrosoftWindows
升级会员 