ADO三大對(duì)象的屬性、方法、事件及常數(shù)（一）

2019-11-18 17:48:32

字體：大中小

供稿：網(wǎng)友

Connection對(duì)象

屬性

屬性名稱(chēng)數(shù)據(jù)類(lèi)型和用途
Attributes可讀寫(xiě)Long類(lèi)型，通過(guò)兩個(gè)常數(shù)之和指定是否使用保留事務(wù)（retainningtransactions）。常數(shù)adXactCommitRetaining表示調(diào)用CommitTrans方法時(shí)啟動(dòng)一個(gè)新事務(wù)；常數(shù)adXactAbortRetaning表示調(diào)用RollbackTrans方法時(shí)啟動(dòng)一個(gè)新事務(wù)。默認(rèn)值為0，表示不使用保留事務(wù)。
CommandTimeout可讀寫(xiě)Long類(lèi)型，指定中止某個(gè)相關(guān)Command對(duì)象的Execute調(diào)用之前必須等待的時(shí)間。默認(rèn)值為30秒。
ConnectionString可讀寫(xiě)String類(lèi)型，提供數(shù)據(jù)提供者或服務(wù)提供者打開(kāi)到數(shù)據(jù)源的連接所需要的特定信息
ConnectionTimeout可讀寫(xiě)Long類(lèi)型，指定中止一個(gè)失敗的Connection.Open方法調(diào)用之前必須等待的時(shí)間，默認(rèn)值為15秒。
CursorLocation可讀寫(xiě)Long類(lèi)型，確定是使用客戶(hù)端(adUseClient)游標(biāo)引擎，還是使用服務(wù)器端(adUseServer)游標(biāo)引擎。默認(rèn)值是adUseServer。
DefaultDatabase可讀寫(xiě)String類(lèi)型，如果ConnectString中未指定數(shù)據(jù)庫(kù)名稱(chēng)，就使用這里所指定的名稱(chēng)，對(duì)SQLServer而言，其值通常是pubs
IsolationLevel可讀寫(xiě)Long類(lèi)型，指定和其他并發(fā)事務(wù)交互時(shí)的行為或事務(wù)。見(jiàn)IsolationLevel常數(shù)
ModeLong類(lèi)型，指定對(duì)Connection的讀寫(xiě)權(quán)限。見(jiàn)Mode常數(shù)
PRovider可讀寫(xiě)String類(lèi)型，如果ConnectionString中未指定OLEDB數(shù)據(jù)或服務(wù)提供者的名稱(chēng)，就使用這時(shí)指定的名稱(chēng)。默認(rèn)值是MSDASQL(MicrosoftOLEDBProviderforODBC)。
State可讀寫(xiě)Long類(lèi)型，指定連接是處于打開(kāi)狀態(tài)，還是處于關(guān)閉狀態(tài)或中間狀態(tài)。見(jiàn)State常數(shù)
Version只讀String類(lèi)型，返回ADO版本號(hào)。

注意：上面所列出的大多數(shù)可讀寫(xiě)的屬性，只有當(dāng)連接處于關(guān)閉狀態(tài)時(shí)才是可寫(xiě)的。

只有當(dāng)用戶(hù)為Connection對(duì)象用BeginTrans...CommitTrans...RollbackTrans方法定義了不遺余力，事務(wù)隔離程度的指定才真正有效。如果有多個(gè)數(shù)據(jù)庫(kù)用戶(hù)同時(shí)執(zhí)行事務(wù)，那么應(yīng)用程序中必須指定如何響應(yīng)運(yùn)行中的其他事務(wù)。

方法

方法用途
BeginTrans初始化一個(gè)事務(wù)；其后必須有CommitTrans和／或RollbackTrans相呼應(yīng)
Close關(guān)閉連接
CommitTrans提交一個(gè)事務(wù)，以完成對(duì)數(shù)據(jù)源的永久改變（要求使用之前必須調(diào)用了BeginTrans方法)
Execute人SELECTSQL語(yǔ)句返回一個(gè)forward-onlyRecordset對(duì)象，也用來(lái)執(zhí)行那些不返回Recordset語(yǔ)句，如INSERT、UPDATE、DELETE查詢(xún)或DDL語(yǔ)句
Open用連接字符串來(lái)打開(kāi)一個(gè)連接
OpenSchema返回一個(gè)Recordset對(duì)象以提供數(shù)據(jù)源的結(jié)構(gòu)信息(metadata)
RollbackTrans取消一個(gè)事務(wù)，恢復(fù)對(duì)數(shù)據(jù)源做的臨時(shí)性改變(要求使用之前必須調(diào)用了BeginTrans方法)

注：只有Execute、Open和OpenSchema三個(gè)方法才能接受變?cè)獏?shù)。Execute的語(yǔ)法為：
cnnName.ExecutestrCommand,[lngRowsAffected[,lngOptions]]
strCommand的值可以是SQL語(yǔ)句、表名、存儲(chǔ)過(guò)程名，也可以是數(shù)據(jù)提供者所能接受的任意字符串。為了提高性能，最好為lngOptions參數(shù)指定合適的值（詳見(jiàn)lngOptions參數(shù)用到的常數(shù)），以使提供者解釋語(yǔ)句時(shí)不用再去判定其類(lèi)型?？蛇x參數(shù)lngRowsAffected將返回INSERT、UPDATE或DELETE查詢(xún)執(zhí)行以后所影響的數(shù)目。這些查詢(xún)會(huì)返回一個(gè)關(guān)閉的Recordset對(duì)象。一個(gè)SELECT查詢(xún)將返回lngRowsAffected值為0并且返回帶有一行或多行內(nèi)容的打開(kāi)的forward-onlyRecordset。

事件

事件名稱(chēng)觸發(fā)時(shí)機(jī)
BeginTransCompleteBeginTrans方法執(zhí)行以后。
PrivateSubcnnName_BeginTransComplet(ByValTransactionLevelAsLong,ByValpErrorAsADODB.Error,adStatusAsADODB.EventStatusEnum,ByValpConnectionAsADODB.Connection)
CommitTransCompleteCommitTrans方法執(zhí)行以后
PrivateSubConnection1_CommitTransComplete(ByValpErrorAsADODB.Error,adStatusAsADODB.EventStatusEnum,ByValpConnectionAsADODB.Connection)
ConnectComplete成功建立到數(shù)據(jù)源的Connection之后
PrivateSubConnection1_ConnectComplete(ByValpErrorAsADODB.Error,adStatusAsADODB.EventStatusEnum,ByValpConnectionAsADODB.Connection)
DisconnectConnection關(guān)閉之后
PrivateSubConnection1_Disconnect(adStatusAsADODB.EventStatusEnum,ByValpConnectionAsADODB.Connection)
ExecuteComplete完成Connection.Execute或Command.Execute之時(shí)
PrivateSubConnection1_ExecuteComplete(ByValRecordsAffectedAsLong,ByValpErrorAsADODB.Error,adStatusAsADODB.EventStatusEnum,ByValpCommandAsADODB.Command,ByValpRecordsetAsADODB.Recordset,ByValpConnectionAsADODB.Connection)
InfoMessage一個(gè)Error對(duì)象被添加到ADODB.Connectio.Error集合之時(shí)
PrivateSubConnection1_InfoMessage(ByValpErrorAsADODB.Error,adStatusAsADODB.EventStatusEnum,ByValpConnectionAsADODB.Connection)
RollbackTransCompleteRollbackTrans方法執(zhí)行之后
PrivateSubConnection1_RollbackTransComplete(ByValpErrorAsADODB.Error,adStatusAsADODB.EventStatusEnum,ByValpConnectionAsADODB.Connection)
WillConnect即將調(diào)用Connection.Open方法之時(shí)
PrivateSubConnection1_WillConnect(ConnectionStringAsString,UserIDAsString,PassWordAsString,OptionsAsLong,adStatusAsADODB.EventStatusEnum,ByValpConnectionAsADODB.Connection)
WillExecute即將調(diào)用Connection.Execute或Command.Execute方法之時(shí)
PrivateSubConnection1_WillExecute(SourceAsString,CursorTypeAsADODB.CursorTypeEnum,LockTypeAsADODB.LockTypeEnum,OptionsAsLong,adStatusAsADODB.EventStatusEnum,ByValpCommandAsADODB.Command,ByValpRecordsetAsADODB.Recordset,ByValpConnectionAsADODB.Connection)

注：其中的adStatus參數(shù)所用到的常數(shù)的名稱(chēng)和含義詳見(jiàn)adStatus所用的常數(shù)

常數(shù)

IsolationLevel常數(shù)

常數(shù)含義
adXactCursorStability只允許讀其他事務(wù)已提交的改變（默認(rèn)值）
adXactBrowse允許讀其他事務(wù)未提交的改變
adXactChaos本事務(wù)不會(huì)覆蓋其他位于更高隔離程度的事務(wù)所做的改變
adXactIsolated所有事務(wù)相互獨(dú)立
adXactReadCommitted等同于adXactCursorStability
adXactReadUncommitted等同于adXactBrowse
adXactRepeatableRead禁止讀其他事務(wù)的改變
adXactSerializable等同于adXactIsolated
adXactUnspecified不能確定提供者的事務(wù)隔離程度

Mode常數(shù)

常數(shù)含義
adModeUnknown未指定數(shù)據(jù)源的連接許可權(quán)（默認(rèn)值）
adModeRead連接是只讀的
adModeReadWrite連接是可讀寫(xiě)的
adModeShareDenyNone不拒絕其他用戶(hù)的讀寫(xiě)訪問(wèn)(JetOLEDBProvider的默認(rèn)值)
adModeShareDenyRead拒絕其他用戶(hù)打開(kāi)到數(shù)據(jù)源的讀連接
adModeShareDenyWrite拒絕其他用戶(hù)打開(kāi)到數(shù)據(jù)源的寫(xiě)連接
adModeShareExclusive以獨(dú)占方式打開(kāi)數(shù)據(jù)源
adModeWrite連接是只寫(xiě)的

State常數(shù)

常數(shù)含義
adStateClosedConnection(或其他對(duì)象)是關(guān)閉的(默認(rèn)值)
adStateConnecting正在連接數(shù)據(jù)源的狀態(tài)
adStateExecutingConnection或Command對(duì)象的Execute方法已被調(diào)用
adStateFetching返回行(row)到Recordset對(duì)象
adStateOpenConnection(或其他對(duì)象)是打開(kāi)的(活動(dòng)的)

Execute方法中l(wèi)ngOption參數(shù)用到的常數(shù)

Command類(lèi)型常數(shù)含義
adCmdUnknownCommand類(lèi)型未定（默認(rèn)值），由數(shù)據(jù)提供者去判別Command語(yǔ)法
adCmdFileCommand是和對(duì)象類(lèi)型相應(yīng)的文件名稱(chēng)
adCmdStoredProcCommand是存儲(chǔ)過(guò)程名稱(chēng)
adCmdTableCommand是能產(chǎn)生內(nèi)部SELECT*FROMTableName查詢(xún)的表名稱(chēng)
adCmdTableDirectCommand是能直接從表中獲取行內(nèi)容的表名稱(chēng)
adCmdTextCommand是一條SQL語(yǔ)句

ADODB事件處理子過(guò)程參數(shù)adStatus所用的常數(shù)

常數(shù)含義
adStatusCancel操作被用戶(hù)取消
adStatusCnatDeny操作不能拒絕其他用戶(hù)對(duì)數(shù)據(jù)源的訪問(wèn)
adStatusErrorsOccurred操作導(dǎo)致錯(cuò)誤并已送到Errors集合中
adStatusOK操作成功
adStatusUnWantedEvent操作過(guò)程中一個(gè)未預(yù)料到的事件被激活->

上一篇：ADO三大對(duì)象的屬性、方法、事件及常數(shù)（二）

下一篇：VB6.0中的幾個(gè)新增數(shù)據(jù)庫(kù)工具