介紹
VC用ADO通路資料庫全攻略,介紹了VC用ADO來通路資料庫的各個對象及各方法,很經典,也很實用,很值得一看。
正文
一、ADO概述
ADO是Microsoft為最新和最強大的資料通路範例 OLE DB 而設計的,是一個便于使用的應用程式層接口。ADO 使您能夠編寫應用程式以通過 OLE. DB 提供者通路和操作資料庫伺服器中的資料。ADO 最主要的優點是易于使用、速度快、記憶體支出少和磁盤遺迹小。ADO 在關鍵的應用方案中使用最少的網絡流量,并且在前端和資料源之間使用最少的層數,所有這些都是為了提供輕量、高性能的接口。之是以稱為 ADO,是用了一個比較熟悉的暗喻,OLE 自動化接口。
OLE DB是一組”元件對象模型”(COM) 接口,是新的資料庫低層接口,它封裝了ODBC的功能,并以統一的方式通路存儲在不同資訊源中的資料。OLE DB是Microsoft UDA(Universal Data Access)政策的技術基礎。OLE DB 為任何資料源提供了高性能的通路,這些資料源包括關系和非關系資料庫、電子郵件和檔案系統、文本和圖形、自定義業務對象等等。也就是說,OLE DB 并不局限于 ISAM、Jet 甚至關系資料源,它能夠處理任何類型的資料,而不考慮它們的格式和存儲方法。在實際應用中,這種多樣性意味着可以通路駐留在 Excel 電子資料表、文本檔案、電子郵件/目錄服務甚至郵件伺服器,諸如 Microsoft Exchange 中的資料。但是,OLE DB 應用程式程式設計接口的目的是為各種應用程式提供最佳的功能,它并不符合簡單化的要求。您需要的API 應該是一座連接配接應用程式和OLE DB 的橋梁,這就是 ActiveX Data Objects (ADO)。
二、在VC中使用ADO(開發步驟好下:)
1、引入ADO庫檔案
使用ADO前必須在工程的stdafx.h頭檔案裡用直接引入符号#import引入ADO庫檔案,以使編譯器能正确編譯。代碼如下所示:
用#import引入ADO庫檔案
#import "c:/program files/common files/system/ado/msado15.dll"no_namespaces rename("EOF" adoEOF")
這行語句聲明在工程中使用ADO,但不使用ADO的名字空間,并且為了避免常數沖突,将常數EOF改名為adoEOF。現在不需添加另外的頭檔案,就可以使用ADO接口了。
2、初始化OLE/COM庫環境
必須注意的是,ADO庫是一組COM動态庫,這意味應用程式在調用ADO前,必須初始化OLE/COM庫環境。在MFC應用程式裡,一個比較好的方法是在應用程式主類的InitInstance成員函數裡初始化OLE/COM庫環境。
BOOL CMyAdoTestApp::InitInstance()
{
if(!AfxOleInit())//這就是初始化COM庫
{
AfxMessageBox(“OLE初始化出錯!”);
return FALSE;
}
……
}
3、ADO接口簡介
ADO庫包含三個基本接口:_ConnectionPtr接口、_CommandPtr接口和_RecordsetPtr接口。
_ConnectionPtr接口傳回一個記錄集或一個空指針。通常使用它來建立一個資料連接配接或執行一條不傳回任何結果的SQL語句,如一個存儲過程。使用_ConnectionPtr接口傳回一個記錄集不是一個好的使用方法。對于要傳回記錄的操作通常用_RecordserPtr來實作。而用_ConnectionPtr操作時要想得到記錄條數得周遊所有記錄,而用_RecordserPtr時不需要。
_CommandPtr接口傳回一個記錄集。它提供了一種簡單的方法來執行傳回記錄集的存儲過程和SQL語句。在使用_CommandPtr接口時,你可以利用全局_ConnectionPtr接口,也可以在_CommandPtr接口裡直接使用連接配接串。如果你隻執行一次或幾次資料通路操作,後者是比較好的選擇。但如果你要頻繁通路資料庫,并要傳回很多記錄集,那麼,你應該使用全局_ConnectionPtr接口建立一個資料連接配接,然後使用_CommandPtr接口執行存儲過程和SQL語句。
_RecordsetPtr是一個記錄集對象。與以上兩種對象相比,它對記錄集提供了更多的控制功能,如記錄鎖定,遊标控制等。同_CommandPtr接口一樣,它不一定要使用一個已經建立的資料連接配接,可以用一個連接配接串代替連接配接指針賦給_RecordsetPtr的connection成員變量,讓它自己建立資料連接配接。如果你要使用多個記錄集,最好的方法是同Command對象一樣使用已經建立了資料連接配接的全局_ConnectionPtr接口
,然後使用_RecordsetPtr執行存儲過程和SQL語句。
4、使用_ConnectionPtr接口
_ConnectionPtr主要是一個連接配接接口,取得與資料庫的連接配接。它的連接配接字元串可以是自己直接寫,也可以指向一個ODBC DSN。。
_ConnectionPtr pConn;
if (FAILED(pConn.CreateInstance("ADODB.Connection")))
{
AfxMessageBox("Create Instance failed!");
return;
}
CString strSRC;
strSRC="Driver=SQL Server;Server=";
strSRC+="suppersoft";
strSRC+=";Database=";
strSRC+="mydb";
strSRC+=";UID=SA;PWD=";
CString strSQL = "Insert into student(no,name,sex,address) values(3,'aaa','male','beijing')";
_variant_t varSRC(strSRC);
_variant_t varSQL(strSQL);
_bstr_t bstrSRC(strSRC);
if (FAILED(pConn->Open(bstrSRC,"","",-1)))
{
AfxMessageBox("Can not open Database!");
pConn.Release();
return;
}
COleVariant vtOptional((long)DISP_E_PARAMNOTFOUND,VT_ERROR);
pConn->Execute(_bstr_t(strSQL),&vtOptional,-1);
pConn.Release();
AfxMessageBox("ok!");
5、使用_RecordsetPtr接口(以連接配接SQL Server為例)
_RecordsetPtr pPtr;
if (FAILED(pPtr.CreateInstance("ADODB.Recordset")))
{
AfxMessageBox("Create Instance failed!");
return FALSE;
}
CString strSRC;
strSRC="Driver=SQL Server;Server=";
strSRC+="210.46.141.145";
strSRC+=";Database=";
strSRC+="mydb";
strSRC+=";UID=sa;PWD=";
strSRC+="sa";
CString strSQL = "select id,name,gender,address from personal";
_variant_t varSRC(strSRC);
_variant_t varSQL(strSQL);
if(FAILED(pPtr->Open(varSQL,varSRC,adOpenStatic,adLockOptimistic,adCmdText)))
{
AfxMessageBox("Open table failed!");
pPtr.Release();
return FALSE;
}
while(!pPtr->GetadoEOF())
{
_variant_t varNo;
_variant_t varName;
_variant_t varSex;
_variant_t varAddress;
varNo = pPtr->GetCollect ("id");
varName = pPtr->GetCollect ("name");
varSex = pPtr->GetCollect ("gender");
varAddress = pPtr->GetCollect ("address");
CString strNo =(char *)_bstr_t(varNo);
CString strName =(char *)_bstr_t(varName);
CString strSex =(char *)_bstr_t(varSex);
CString strAddress =(char *)_bstr_t(varAddress);
strNo.TrimRight();
strName.TrimRight();
strSex.TrimRight();
strAddress.TrimRight();
int nCount = m_list.GetItemCount();
int nItem = m_list.InsertItem (nCount,_T(""));
m_list.SetItemText (nItem,0,strNo);
m_list.SetItemText (nItem,1,strName);
m_list.SetItemText (nItem,2,strSex);
m_list.SetItemText (nItem,3,strAddress);
pPtr->MoveNext();
}
pPtr->Close();
pPtr.Release();
6、使用_CommandPtr接口
_CommandPtr接口傳回一個Recordset對象,并且提供了更多的記錄集控制功能,以下代碼示例了使用_CommandPtr接口的方法:
代碼11:使用_CommandPtr接口擷取資料
_CommandPtr pCommand;
_RecordsetPtr pRs;
pCommand.CreateInstance(__uuidof(Command));
pCommand->ActiveConnection=pConn;
pCommand->CommandText="select * from student";
pCommand->CommandType=adCmdText;
pCommand->Parameters->Refresh();
pRs=pCommand->Execute(NULL,NULL,adCmdUnknown);
_variant_t varValue = pRs->GetCollect("name");
CString strValue=(char*)_bstr_t(varValue);
6、關于資料類型轉換由于COM對象是跨平台的,它使用了一種通用的方法來處理各種類型的資料,
是以Cstring 類和COM對象是不相容的,我們需要一組API來轉換COM對象和C++類型的資料。_vatiant_t和_bstr_t就是這樣兩種對象。它們提供了通用的方法轉換COM對象和C++類型的資料。
............................................................................................
1. 生成應用程式架構并初始化OLE/COM庫環境
建立一個标準的MFC AppWizard(exe)應用程式,然後在使用ADO資料庫的InitInstance函數中初始化OLE/COM庫(因為ADO庫是一個COM DLL庫)。
本例為:
BOOL CAdotestDlg::OnInitDialog()
{
::CoInitialize(NULL); //初始化OLE/COM庫環境
}
程式最後要調用 ::CoUninitialize();//釋放程式占用的COM 資源。
另外:
m_pRecordset->Close(); 注意!!!不要多次關閉!!!!!!!!!!!!
m_pConnection->Close();
m_pRecordset = NULL;
m_pConnection = NULL;
2. 引入ADO庫檔案
使用ADO前必須在工程的stdafx.h檔案最後用直接引入符号#import引入ADO庫檔案,以使編譯器能正确編譯。代碼如下:
#import "C:/Program Files/common files/system/ado/msado15.dll" no_namespace rename("EOF","adoEOF")
ADO類的定義是作為一種資源存儲在ADO DLL(msado15.dll)中,在其内部稱為類型庫。類型庫描述了自治接口,以及C++使用的COM vtable接口。當使用#import指令時,在運作時Visual C++需要從ADO DLL中讀取這個類型庫,并以此建立一組C++頭檔案。這些頭檔案具有.tli 和.tlh擴充名,讀者可以在項目的目錄下找到這兩個檔案。在C++程式代碼中調用的ADO類要在這些檔案中定義。
程式的第三行訓示ADO對象不使用名稱空間。在有些應用程式中,由于應用程式中的對象與ADO中的對象之間可能會出現命名沖突,是以有必要使用名稱空間。如果要使用名稱空間,則可把第三行程式修改為: rename_namespace("AdoNS")。第四行代碼将ADO中的EOF(檔案結束)更名為adoEOF,以避免與定義了自己的EOF的其他庫沖突。
3.利用智能指針進行資料庫操作
在CaboutDlg頭檔案中定義兩個ADO智能指針類執行個體,并在對話框中加入一個ListCtrl。
class CAdotestDlg : public CDialog
{
_ConnectionPtr m_pConnection;
_RecordsetPtr m_pRecordset;
ClistCtrl m_List;
......
}
ADO庫包含三個智能指針:_ConnectionPtr、_CommandPtr和_RecordsetPtr。
_ConnectionPtr通常被用來建立一個資料連接配接或執行一條不傳回任何結果的SQL語句,如一個存儲過程。
_CommandPtr傳回一個記錄集。它提供了一種簡單的方法來執行傳回記錄集的存儲過程和SQL語句。在使用_CommandPtr接口時,可以利用全局_ConnectionPtr接口,也可以在_CommandPtr接口裡直接使用連接配接串。 _RecordsetPtr是一個記錄集對象。與以上兩種對象相比,它對記錄集提供了更多的控制功能,如記錄鎖定、遊标控制等。
在使用ADO程式的事件響應中OnButton1加入以下代碼:
void CAdotestDlg::OnButton1()
{
m_List.ResetContent();
m_pConnection.CreateInstance(_uuidof(Connection)); //初始化Connection指針
m_pRecordset.CreateInstance(_uuidof(Recordset));//初始化Recordset指針
try
{
m_pConnection->Open("DSN=ADOTest","","",0); //連接配接叫作ADOTest的ODBC資料源
//注意:這是連接配接不需要使用者ID或密碼的open 函數
// 否則形式為 ->Open("DSN=test;uid=sa;pwd=123;","","",0);
// 執行SQL語句得到一個記錄集把其指針指派給m_pRecordset
CString strSql="select * from middle";
BSTR bstrSQL = strSql.AllocSysString();
m_pRecordset->Open(bstrSQL,(IDispatch*)m_pConnection,adOpenDynamic,adLockOptimistic,adCmdText);
//adOpenDynamic:動态 adLockOptimistic樂觀封鎖法 adCmdText:文本查詢語句
while(!m_pRecordset->adoEOF)//周遊所有記錄
{
//取紀錄字段值方式之一
_variant_t TheValue; //VARIANT資料類型
TheValue = m_pRecordset->GetCollect("BIG_NAME");//得到字段BIG_NAME的值
if(TheValue.vt!=VT_NULL)
m_List.AddString((char*)_bstr_t(TheValue));
//将該值加入到清單控件中
//取紀錄字段值方式之二
// _bstr_t TheValue1=m_pRecordset->Fields->GetItem("BIG_NAME")->Value;
// CString temp=TheValue1.copy();
// m_List.AddString(temp);
//資料類型轉換
_variant_t vUsername,vBirthday,vID,vOld;
TRACE("id:%d,姓名:%s,年齡:%d,生日:%s/r/n",
vID.lVal,(LPCTSTR)(_bstr_t)vUsername,vOld.lVal,(LPCTSTR)(_bstr_t)vBirthday);
m_pRecordset->MoveNext();//轉到下一條紀錄
}
m_pRecordset->Close();
m_pConnection->Close();
}
catch (_com_error e)//異常處理
{
AfxMessageBox(e.ErrorMessage());
}
m_pRecordset->Close(); //注意!!!不要多次關閉!!!!否則會出錯
m_pConnection->Close();
m_pRecordset = NULL;
m_pConnection = NULL;
}
程式中通過_variant_t和_bstr_t轉換COM對象和C++類型的資料, _variant_t類封裝了OLE自治VARIANT資料類型。在C++中使用_variant_t類要比直接使用VARIANT資料類型容易得多。
好,編譯後該程式就能運作了,但記住運作前要建立一個叫ADOTest的ODBC資料源。該程式将把表middle中的BIG_NAME字段值顯示在清單控件中。
在Visual C++中用ADO進行資料庫程式設計(中)
4.執行SQL指令并取得結果記錄集
為了取得結果記錄集,我們定義一個指向Recordset對象的指針:_RecordsetPtr m_pRecordset;
并為其建立Recordset對象的執行個體: m_pRecordset.CreateInstance("ADODB.Recordset");
SQL指令的執行可以采用多種形式,下面我們一進行闡述。
(1)利用Connection對象的Execute方法執行SQL指令
Execute方法的原型如下所示:
_RecordsetPtr Connection15::Execute ( _bstr_t CommandText, VARIANT * RecordsAffected, long Options )
其中CommandText是指令字串,通常是SQL指令。
參數RecordsAffected是操作完成後所影響的行數,
參數Options表示CommandText中内容的類型,Options可以取如下值之一:
adCmdText:表明CommandText是文本指令
adCmdTable:表明CommandText是一個表名
adCmdProc:表明CommandText是一個存儲過程
adCmdUnknown:未知
Execute執行完後傳回一個指向記錄集的指針,下面我們給出具體代碼并作說明。
_variant_t RecordsAffected;
///執行SQL指令:CREATE TABLE建立表格users,users包含四個字段:整形ID,字元串username,整形old,日期型birthday
m_pConnection->Execute("CREATE TABLE users(ID INTEGER,username TEXT,old INTEGER,birthday DATETIME)",
&RecordsAffected,
adCmdText);
///往表格裡面添加記錄
m_pConnection->Execute("INSERT INTO users(ID,username,old,birthday) VALUES (1, ''''Washington'''',25,''''1970/1/1'''')",&RecordsAffected,adCmdText);
///将所有記錄old字段的值加一
m_pConnection->Execute("UPDATE users SET old = old+1",&RecordsAffected,adCmdText);
///執行SQL統計指令得到包含記錄條數的記錄集
m_pRecordset = m_pConnection->Execute("SELECT COUNT(*) FROM users",&RecordsAffected,adCmdText);
_variant_t vIndex = (long)0;
_variant_t vCount = m_pRecordset->GetCollect(vIndex);///取得第一個字段的值放入vCount變量
上兩句可以寫成— _variant_t vCount = m_pRecordset->GetCollect((_variant_t)((long)0));
m_pRecordset->Close();///關閉記錄集
CString message;
message.Format("共有%d條記錄",vCount.lVal);
AfxMessageBox(message);///顯示目前記錄條數
(2)利用Command對象來執行SQL指令
_CommandPtr m_pCommand;
m_pCommand.CreateInstance("ADODB.Command");
_variant_t vNULL;
vNULL.vt = VT_ERROR;
vNULL.scode = DISP_E_PARAMNOTFOUND;///定義為無參數
m_pCommand->ActiveConnection = m_pConnection;///非常關鍵的一句,将建立的連接配接指派給它
m_pCommand->CommandText = "SELECT * FROM users";///指令字串
m_pRecordset = m_pCommand->Execute(&vNULL,&vNULL,adCmdText);///執行指令,取得記錄集
在這段代碼中我們隻是用Command對象來執行了SELECT查詢語句,Command對象在進行存儲過程的調用中能真正展現它的作用。下次我們将詳細介紹。
(3)直接用Recordset對象進行查詢取得記錄集
執行個體——
void CGmsaDlg::OnDBSelect()
{
// TODO: Add your control notification handler code here
_RecordsetPtr Rs1; //定義Recordset對象
_bstr_t Connect("DSN=GMS;UID=sa;PWD=;");//定義連接配接字元串
_bstr_t Source ("SELECT count(*) FROM buaa.mdb010"); //要執行的SQL語句
::CoInitialize(NULL); //初始化Rs1對象
HRESUL hr = Rs1.CreateInstance( __uuidof( Recordset ) );
//省略對傳回值hr的判斷
Rs1->Open( Source,
Connect,
adOpenForwardOnly,
adLockReadOnly,
-1 );
_variant_t temp=Rs1->GetCollect(_variant_t((long)0));
CString strTemp=(char* )(_bstr_t)temp;
MessageBox("OK!"+strTemp);
}
例如
m_pRecordset->Open("SELECT * FROM users",
_variant_t((IDispatch *)m_pConnection,true),
adOpenStatic,
adLockOptimistic,
adCmdText);
Open方法的原型是這樣的:
HRESULT Recordset15::Open ( const _variant_t & Source,
const _variant_t & ActiveConnection,
enum CursorTypeEnum CursorType,
enum LockTypeEnum LockType,
long Options )
其中:
①Source是資料查詢字元串
②ActiveConnection是已經建立好的連接配接(我們需要用Connection對象指針來構造一個_variant_t對象)
③CursorType光标類型,它可以是以下值之一,請看這個枚舉結構:
enum CursorTypeEnum
{
adOpenUnspecified = -1,///不作特别指定
adOpenForwardOnly = 0,///前滾靜态光标。這種光标隻能向前浏覽記錄集,比如用MoveNext向前滾動,這種方式可以提高浏覽速度。但諸如BookMark,RecordCount,AbsolutePosition,AbsolutePage都不能使用
adOpenKeyset = 1,///采用這種光标的記錄集看不到其它使用者的新增、删除操作,但對于更新原有記錄的操作對你是可見的。
adOpenDynamic = 2,///動态光标。所有資料庫的操作都會立即在各使用者記錄集上反應出來。
adOpenStatic = 3///靜态光标。它為你的記錄集産生一個靜态備份,但其它使用者的新增、删除、更新操作對你的記錄集來說是不可見的。
};
④LockType鎖定類型,它可以是以下值之一,請看如下枚舉結構:
enum LockTypeEnum
{
adLockUnspecified = -1,///未指定
adLockReadOnly = 1,///隻讀記錄集
adLockPessimistic = 2,悲觀鎖定方式。資料在更新時鎖定其它所有動作,這是最安全的鎖定機制
adLockOptimistic = 3,樂觀鎖定方式。隻有在你調用Update方法時才鎖定記錄。在此之前仍然可以做資料的更新、插入、删除等動作
adLockBatchOptimistic = 4,樂觀分批更新。編輯時記錄不會鎖定,更改、插入及删除是在批處理模式下完成。
};
⑤Options可以取如下值之一:
adCmdText:表明CommandText是文本指令
adCmdTable:表明CommandText是一個表名
adCmdProc:表明CommandText是一個存儲過程
adCmdUnknown:未知
10、邦定資料
定義一個綁定類,将其成員變量綁定到一個指定的記錄集,以友善于通路記錄集的字段值。
(1). 從CADORecordBinding派生出一個類:
class CCustomRs : public CADORecordBinding
{
BEGIN_ADO_BINDING(CCustomRs)
ADO_VARIABLE_LENGTH_ENTRY2(3, adVarChar, m_szau_fname,
sizeof(m_szau_fname), lau_fnameStatus, false)
ADO_VARIABLE_LENGTH_ENTRY2(2, adVarChar, m_szau_lname,
sizeof(m_szau_lname), lau_lnameStatus, false)
ADO_VARIABLE_LENGTH_ENTRY2(4, adVarChar, m_szphone,
sizeof(m_szphone), lphoneStatus, true)
END_ADO_BINDING()
public:
CHAR m_szau_fname[22];
ULONG lau_fnameStatus;
CHAR m_szau_lname[42];
ULONG lau_lnameStatus;
CHAR m_szphone[14];
ULONG lphoneStatus;
};
其中将要綁定的字段與變量名用BEGIN_ADO_BINDING宏關聯起來。每個字段對應于兩個變量,一個存放字段的值,另一個存放字段的狀态。字段用從1開始的序号表示,如1,2,3等等。
特别要注意的是:如果要綁定的字段是字元串類型,則對應的字元數組的元素個數一定要比字段長度大2(比如m_szau_fname[22],其綁定的字段au_fname的長度實際是20),不這樣綁定就會失敗。我分析多出的2可能是為了存放字元串結尾的空字元null和BSTR字元串開頭的一個字(表示BSTR的長度)。這個問題對于初學者來說可能是一個意想不到的問題。
CADORecordBinding類的定義在icrsint.h檔案裡,内容是:
class CADORecordBinding
{
public:
STDMETHOD_(const ADO_BINDING_ENTRY*, GetADOBindingEntries) (VOID) PURE;
};
BEGIN_ADO_BINDING宏的定義也在icrsint.h檔案裡,内容是:
#define BEGIN_ADO_BINDING(cls) public: /
typedef cls ADORowClass; /
const ADO_BINDING_ENTRY* STDMETHODCALLTYPE GetADOBindingEntries() { /
static const ADO_BINDING_ENTRY rgADOBindingEntries[] = {
ADO_VARIABLE_LENGTH_ENTRY2宏的定義也在icrsint.h檔案裡:
#define ADO_VARIABLE_LENGTH_ENTRY2(Ordinal, DataType, Buffer, Size, Status, Modify)/
{Ordinal, /
DataType, /
0, /
0, /
Size, /
offsetof(ADORowClass, Buffer), /
offsetof(ADORowClass, Status), /
0, /
classoffset(CADORecordBinding, ADORowClass), /
Modify},
#define END_ADO_BINDING宏的定義也在icrsint.h檔案裡:
#define END_ADO_BINDING() {0, adEmpty, 0, 0, 0, 0, 0, 0, 0, FALSE}};/
return rgADOBindingEntries;}
(2). 綁定
_RecordsetPtr Rs1;
IADORecordBinding *picRs=NULL;
CCustomRs rs;
......
Rs1->QueryInterface(__uuidof(IADORecordBinding),
(LPVOID*)&picRs));
picRs->BindToRecordset(&rs);
派生出的類必須通過IADORecordBinding接口才能綁定,調用它的BindToRecordset方法就行了。
(3). rs中的變量即是目前記錄字段的值
//Set sort and filter condition:
// Step 4: Manipulate the data
Rs1->Fields->GetItem("au_lname")->Properties->GetItem("Optimize")->Value = true;
Rs1->Sort = "au_lname ASC";
Rs1->Filter = "phone LIKE '415 5*'";
Rs1->MoveFirst();
while (VARIANT_FALSE == Rs1->EndOfFile)
{
printf("Name: %s/t %s/tPhone: %s/n",
(rs.lau_fnameStatus == adFldOK ? rs.m_szau_fname : ""),
(rs.lau_lnameStatus == adFldOK ? rs.m_szau_lname : ""),
(rs.lphoneStatus == adFldOK ? rs.m_szphone : ""));
if (rs.lphoneStatus == adFldOK)
strcpy(rs.m_szphone, "777");
TESTHR(picRs->Update(&rs)); // Add change to the batch
Rs1->MoveNext();
}
Rs1->Filter = (long) adFilterNone;
......
if (picRs) picRs->Release();
Rs1->Close();
pConn->Close();
隻要字段的狀态是adFldOK,就可以通路。如果修改了字段,不要忘了先調用picRs的Update(注意不是Recordset的Update),然後才關閉,也不要忘了釋放picRs(即picRs->Release();)。
(4). 此時還可以用IADORecordBinding接口添加新紀錄
if(FAILED(picRs->AddNew(&rs)))
......
11. 通路長資料
在Microsoft SQL中的長資料包括text、image等這樣長類型的資料,作為二進制位元組來對待。
可以用Field對象的GetChunk和AppendChunk方法來通路。每次可以讀出或寫入全部資料的一部分,它會記住上次通路的位置。但是如果中間通路了别的字段後,就又得從頭來了。
請看下面的例子:
//寫入一張照片到資料庫:
VARIANT varChunk;
SAFEARRAY *psa;
SAFEARRAYBOUND rgsabound[1];
//VT_ARRAY │ VT_UI1
CFile f("h://aaa.jpg",Cfile::modeRead);
BYTE bVal[ChunkSize+1];
UINT uIsRead=0;
//Create a safe array to store the array of BYTES
while(1)
{
uIsRead=f.Read(bVal,ChunkSize);
if(uIsRead==0)break;
rgsabound[0].cElements =uIsRead;
rgsabound[0].lLbound = 0;
psa = SafeArrayCreate(VT_UI1,1,rgsabound);
for(long index=0;index<uIsRead;index++)
{
if(FAILED(SafeArrayPutElement(psa,&index,&bVal[index])))
::MessageBox(NULL,"啊,又出毛病了。","提示",MB_OK │ MB_ICONWARNING);
}
varChunk.vt = VT_ARRAY│VT_UI1;
varChunk.parray = psa;
try{
m_pRecordset->Fields->GetItem("photo")->AppendChunk(varChunk);
}
catch (_com_error &e)
{
CString str=(char*)e.Description();
::MessageBox(NULL,str+"/n又出毛病了。","提示",MB_OK │ MB_ICONWARNING);
}
::VariantClear(&varChunk);
::SafeArrayDestroyData( psa);
if(uIsRead<ChunkSize)break;
}//while(1)
f.Close();
//從資料庫讀一張照片:
CFile f;
f.Open("h://bbb.jpg",Cfile::modeWrite│Cfile::modeCreate);
long lPhotoSize = m_pRecordset->Fields->Item["photo"]->ActualSize;
long lIsRead=0;
_variant_t varChunk;
BYTE buf[ChunkSize];
while(lPhotoSize>0)
{
lIsRead=lPhotoSize>=ChunkSize? ChunkSize:lPhotoSize;
varChunk = m_pRecordset->Fields->
Item["photo"]->GetChunk(lIsRead);
for(long index=0;index<lIsRead;index++)
{
::SafeArrayGetElement(varChunk.parray,&index,buf+index);
}
f.Write(buf,lIsRead);
lPhotoSize-=lIsRead;
}//while()
f.Close();
12. 使用SafeArray問題
學會使用SafeArray也是很重要的,因為在ADO程式設計中經常要用。它的主要目的是用于automation中的數組型參數的傳遞。因為在網絡環境中,數組是不能直接傳遞的,而必須将其包裝成SafeArray。實質上SafeArray就是将通常的數組增加一個描述符,說明其維數、長度、邊界、元素類型等資訊。SafeArray也并不單獨使用,而是将其再包裝到VARIANT類型的變量中,然後才作為參數傳送出去。在VARIANT的vt成員的值如果包含VT_ARRAY│...,那麼它所封裝的就是一個SafeArray,它的parray成員即是指向SafeArray的指針。SafeArray中元素的類型可以是VARIANT能封裝的任何類型,包括VARIANT類型本身。
使用SafeArray的具體步驟:
方法一:
包裝一個SafeArray:
(1). 定義變量,如:
VARIANT varChunk;
SAFEARRAY *psa;
SAFEARRAYBOUND rgsabound[1];
(2). 建立SafeArray描述符:
uIsRead=f.Read(bVal,ChunkSize);//read array from a file.
if(uIsRead==0)break;
rgsabound[0].cElements =uIsRead;
rgsabound[0].lLbound = 0;
psa = SafeArrayCreate(VT_UI1,1,rgsabound);
(3). 放置資料元素到SafeArray:
for(long index=0;index<uIsRead;index++)
{
if(FAILED(SafeArrayPutElement(psa,&index,&bVal[index])))
::MessageBox(NULL,"出毛病了。","提示",MB_OK │ MB_ICONWARNING);
}
一個一個地放,挺麻煩的。
(4). 封裝到VARIANT内:
varChunk.vt = VT_ARRAY│VT_UI1;
varChunk.parray = psa;
這樣就可以将varChunk作為參數傳送出去了。
讀取SafeArray中的資料的步驟:
(1). 用SafeArrayGetElement一個一個地讀
BYTE buf[lIsRead];
for(long index=0;index<lIsRead;index++)
{
::SafeArrayGetElement(varChunk.parray,&index,buf+index);
}
就讀到緩沖區buf裡了。
方法二:
使用SafeArrayAccessData直接讀寫SafeArray的緩沖區:
(1). 讀緩沖區:
BYTE *buf;
SafeArrayAccessData(varChunk.parray, (void **)&buf);
f.Write(buf,lIsRead);
SafeArrayUnaccessData(varChunk.parray);
(2). 寫緩沖區:
BYTE *buf;
::SafeArrayAccessData(psa, (void **)&buf);
for(long index=0;index<uIsRead;index++)
{
buf[index]=bVal[index];
}
::SafeArrayUnaccessData(psa);
varChunk.vt = VT_ARRAY│VT_UI1;
varChunk.parray = psa;
這種方法讀寫SafeArray都可以,它直接操縱SafeArray的資料緩沖區,比用SafeArrayGetElement和SafeArrayPutElement速度快。特别适合于讀取資料。但用完之後不要忘了調用::SafeArrayUnaccessData(psa),否則會出錯的。
13. 使用書簽( bookmark )
書簽可以唯一辨別記錄集中的一個記錄,用于快速地将目前記錄移回到已通路過的記錄,以及進行過濾等等。Provider會自動為記錄集中的每一條記錄産生一個書簽,我們隻需要使用它就行了。我們不能試圖顯示、修改或比較書簽。ADO用記錄集的Bookmark屬性表示目前記錄的書簽。
用法步驟:
(1). 建立一個VARIANT類型的變量
_variant_t VarBookmark;
(2). 将目前記錄的書簽值存入該變量
也就是記錄集的Bookmark屬性的目前值。
VarBookmark = rst->Bookmark;
(3). 傳回到先前的記錄
将儲存的書簽值設定到記錄集的書簽屬性中:
// Check for whether bookmark set for a record
if (VarBookmark.vt == VT_EMPTY)
printf("No Bookmark set!/n");
else
rst->Bookmark = VarBookmark;
設定完後,目前記錄即會移動到該書簽指向的記錄。
14、設定過濾條件
Recordset對象的Filter屬性表示了目前的過濾條件。它的值可以是以AND或OR連接配接起來的條件表達式(不含WHERE關鍵字)、由書簽組成的數組或ADO提供的FilterGroupEnum枚舉值。為Filter屬性設定新值後Recordset的目前記錄指針會自動移動到滿足過濾條件的第一個記錄。例如:
rst->Filter = _bstr_t ("姓名='趙薇' AND 性别=’女’");
在使用條件表達式時應注意下列問題:
(1)、可以用圓括号組成複雜的表達式
例如:
rst->Filter = _bstr_t ("(姓名='趙薇' AND 性别=’女’) OR AGE<25");
但是微軟不允許在括号内用OR,然後在括号外用AND,例如:
rst->Filter = _bstr_t ("(姓名='趙薇' OR 性别=’女’) AND AGE<25");
必須修改為:
rst->Filter = _bstr_t ("(姓名='趙薇' AND AGE<25) OR (性别=’女’ AND AGE<25)");
(2)、表達式中的比較運算符可以是LIKE
LIKE後被比較的是一個含有通配符*的字元串,星号表示若幹個任意的字元。
字元串的首部和尾部可以同時帶星号*
rst->Filter = _bstr_t ("姓名 LIKE '*趙*' ");
也可以隻是尾部帶星号:
rst->Filter = _bstr_t ("姓名 LIKE '趙*' ");
Filter屬性值的類型是Variant,如果過濾條件是由書簽組成的數組,則需将該數組轉換為SafeArray,然後再封裝到一個VARIANT或_variant_t型的變量中,再賦給Filter屬性。
15、索引與排序
(1)、建立索引
當以某個字段為關鍵字用Find方法查找時,為了加快速度可以以該字段為關鍵字在記錄集内部臨時建立索引。隻要将該字段的Optimize屬性設定為true即可,例如:
pRst->Fields->GetItem("姓名")->Properties->
GetItem("Optimize")->PutValue("True");
pRst->Find("姓名 = '趙薇'",1,adSearchForward);
......
pRst->Fields->GetItem("姓名")->Properties->
GetItem("Optimize")->PutValue("False");
pRst->Close();
說明:Optimize屬性是由Provider提供的屬性(在ADO中稱為動态屬性),ADO本身沒有此屬性。
(2)、排序
要排序也很簡單,隻要把要排序的關鍵字清單設定到Recordset對象的Sort屬性裡即可,例如:
pRstAuthors->CursorLocation = adUseClient;
pRstAuthors->Open("SELECT * FROM mytable",
_variant_t((IDispatch *) pConnection),
adOpenStatic, adLockReadOnly, adCmdText);
......
pRst->Sort = "姓名 DESC, 年齡 ASC";
關鍵字(即字段名)之間用逗号隔開,如果要以某關鍵字降序排序,則應在該關鍵字後加一空格,再加DESC(如上例)。升序時ASC加不加無所謂。本操作是利用索引進行的,并未進行實體排序,是以效率較高。
但要注意,在打開記錄集之前必須将記錄集的CursorLocation屬性設定為adUseClient,如上例所示。Sort屬性值在需要時随時可以修改。
16、事務處理
ADO中的事務處理也很簡單,隻需分别在适當的位置調用Connection對象的三個方法即可,這三個方法是:
(1)、在事務開始時調用
pCnn->BeginTrans();
(2)、在事務結束并成功時調用
pCnn->CommitTrans ();
(3)、在事務結束并失敗時調用
pCnn->RollbackTrans ();
在使用事務處理時,應盡量減小事務的範圍,即減小從事務開始到結束(送出或復原)之間的時間間隔,以便提高系統效率。需要時也可在調用BeginTrans()方法之前,先設定Connection對象的IsolationLevel屬性值,詳細内容參見MSDN中有關ADO的技術資料。
三、使用ADO程式設計常見問題解答
以下均是針對MS SQL 7.0程式設計時所遇問題進行讨論。
1、連接配接失敗可能原因
Enterprise Managemer内,打開将伺服器的屬性對話框,在Security頁籤中,有一個選項Authentication。
如果該選項是Windows NT only,則你的程式所用的連接配接字元串就一定要包含Trusted_Connection參數,并且其值必須為yes,如:
"Provider=SQLOLEDB;Server=888;Trusted_Connection=yes"
";Database=master;uid=lad;";
如果不按上述操作,程式運作時連接配接必然失敗。
如果Authentication選項是SQL Server and Windows NT,則你的程式所用的連接配接字元串可以不包含Trusted_Connection參數,如:
"Provider=SQLOLEDB;Server=888;Database=master;uid=lad;pwd=111;";
因為ADO給該參數取的預設值就是no,是以可以省略。我認為還是取預設值比較安全一些。
2、改變目前資料庫的方法
使用Tansct-SQL中的USE語句即可。
3、如何判斷一個資料庫是否存在
(1)、可打開master資料庫中一個叫做SCHEMATA的視圖,其内容列出了該伺服器上所有的資料庫名稱。
(2) 、更簡便的方法是使用USE語句,成功了就存在;不成功,就不存在。例如:
try{
m_pConnect->Execute ( _bstr_t("USE INSURANCE_2002"),NULL,
adCmdText│adExecuteNoRecords );
}
catch (_com_error &e)
{
blSuccess=FALSE;
CString str="資料庫INSURANCE_2002不存在!/n";
str+=e.Description();
::MessageBox(NULL,str,"警告",MB_OK │ MB_ICONWARNING);
}
4、判斷一個表是否存在
(1)、同樣判斷一個表是否存在,也可以用是否成功地打開它來判斷,十分友善,例如:
try{
m_pRecordset->Open(_variant_t("mytable"),
_variant_t((IDispatch *)m_pConnection,true), adOpenKeyset,
adLockOptimistic, adCmdTable);
}
catch (_com_error &e)
{
::MessageBox(NULL,"該表不存在。","提示",MB_OK │ MB_ICONWARNING);
}
(2)、要不然可以采用麻煩一點的辦法,就是在MS-SQL伺服器上的每個資料庫中都有一個名為sysobjects的表,檢視此表的内容即知指定的表是否在該資料庫中。
(3)、同樣,每個資料庫中都有一個名為TABLES的視圖(View),檢視此視圖的内容即知指定的表是否在該資料庫中。
5、類型轉換問題
(1)、類型VARIANT_BOOL
類型VARIANT_BOOL等價于short類型。The VARIANT_BOOL is equivalent to short. see it's definition below:
typdef short VARIANT_BOOL
(2)、_com_ptr_t類的類型轉換
_ConnectionPtr可以自動轉換成IDspatch*類型,這是因為_ConnectionPtr實際上是_com_ptr_t類的一個執行個體,而這個類有此類型轉換函數。
同理,_RecordsetPtr和_CommandPtr也都可以這樣轉換。
(3)、_bstr_t和_variant_t類
在ADO程式設計時,_bstr_t和_variant_t這兩個類很有用,省去了許多BSTR和VARIANT類型轉換的麻煩。
6、打開記錄集時的問題
在打開記錄集時,在調用Recordset的Open方法時,其最後一個參數裡一定不能包含adAsyncExecute,否則将因為是異步操作,在讀取資料時無法讀到資料。
7、異常處理問題
對所有調用ADO的語句一定要用try和catch語句捕捉異常,否則在發生異常時,程式會異常退出。
8、使用SafeArray問題
在初學使用中,我曾遇到一個傷腦筋的問題,一定要注意:
在定義了SAFEARRAY的指針後,如果打算重複使用多次,則在中間可以調用::SafeArrayDestroyData釋放資料,但決不能調用::SafeArrayDestroyDescriptor,否則必然出錯,即使調用SafeArrayCreate也不行。例如:
SAFEARRAY *psa;
......
//When the data are no longer to be used:
::SafeArrayDestroyData( psa);
我分析在定義psa指針時,一個SAFEARRAY的執行個體(也就是SAFEARRAY描述符)也同時被自動建立了。但是隻要一調用::SafeArrayDestroyDescriptor,描述符就被銷毀了。
是以我認為::SafeArrayDestroyDescriptor可以根本就不調用,即使調用也必須在最後調用。
9、重複使用指令對象問題
一個指令對象如果要重複使用多次(尤其是帶參數的指令),則在第一次執行之前,應将它的Prepared屬性設定為TRUE。這樣會使第一次執行減慢,但卻可以使以後的執行全部加快。
10、綁定字元串型字段問題
如果要綁定的字段是字元串類型,則對應的字元數組的元素個數一定要比字段長度大2(比如m_szau_fname[22],其綁定的字段au_fname的長度實際是20),不這樣綁定就會失敗。
11、使用AppendChunk的問題
當用AddNew方法剛剛向記錄集内添加一個新記錄之後,不能首先向一個長資料字段(image類型)寫入資料,必須先向其他字段寫入過資料之後,才能調用AppendChunk寫該字段,否則出錯。也就是說,AppendChunk不能緊接在AddNew之後。另外,寫入其他字段後還必須緊接着調用AppendChunk,而不能調用記錄集的Update方法後,才調用AppendChunk,否則調用AppendChunk時也會出錯。換句話說,就是必須AppendChunk在前,Update在後。因而這個時候就不能使用帶參數的AddNew了,因為帶參數的AddNew會自動調用記錄集的Update,是以AppendChunk就跑到Update的後面了,就隻有出錯了!是以,這時應該用不帶參數的AddNew。
我推測這可能是MS SQL 7.0的問題,在MS SQL 2000中則不存在這些問題,但是AppendChunk仍然不能在Update之後。
四、小結
一般情況下,Connection和Command的Execute用于執行不産生記錄集的指令,而Recordset的Open用于産生一個記錄集,當然也不是絕對的。特别Command主要是用于執行參數化的指令,可以直接由Command對象執行,也可以将Command對象傳遞給Recordset的Open。
本文中的代碼片斷均在VC++ 6.0、Windows NT 4.0 SP6和MS SQL 7.0中調試通過。相信您讀過之後,編寫簡單的資料庫程式應該沒有問題了。當然要編寫比較實用的、複雜一點的程式,還需要對OLE DB、ADO以及資料庫平台再多了解一點,希望您繼續努力,一定會很快成功的!詳細參考資料請參見微軟MSDN July 2000CD光牒或MS SQL 7.0線上文檔資料(Books online)。文中難免有錯誤和不妥之處,敬請各位批評指正!
............................................................................................
ADO 資料庫連接配接-執行個體分析-VC
文章出處:豆豆技術網 釋出時間:2005-12-27
這些天一直在學習ADO 資料庫 連接配接,感覺比較複雜,是以一邊學習,一邊使用,一邊做了一些筆記,下面的一些東西就是我總結的一些關于ADO資料庫連接配接方面的東西,因為是筆記,是以不一定很有序,貼出來的意思一方面是可以給大家一個參考,一邊也有希望大家一起來完善的意思,其中錯誤和不足之處當然希望大家可以及時地通知我,在貼上來的時候,我有一個想法,因為我在使用的過程中,總是會遇上一些莫明其妙的錯誤,是以我想大家有可能也會遇上,于是,我給出了一個錯誤總結,當然這裡就需要大家一起來完善了,如果大家有什麼心得和見解,希望在評論中留言,我會及時地接受大家的意見并把他們加進來(當然是在得到您的允許的情況下)
1、導入庫檔案
使用ADO前必須在工程的stdafx.h檔案最後用直接引入符号#import引入ADO庫檔案,以使編譯器能正确編譯。代碼如下:
#import "C:Program Filescommon filessystemadomsado15.dll" no_namespace rename("EOF","EndOfFile") rename("BOF","FirstOfFile")
ADO類的定義是作為一種資源存儲在ADO DLL(msado15.dll)中,在其内部稱為類型庫。類型庫描述了自治接口,以及C++使用的COM vtable接口。當使用#import指令時,在運作時Visual C++需要從ADO DLL中讀取這個類型庫,并以此建立一組C++頭檔案。這些頭檔案具有.tli 和.tlh擴充名,讀者可以在項目的目錄下找到這兩個檔案。在C++程式代碼中調用的ADO類要在這些檔案中定義。
程式的第三行訓示ADO對象不使用名稱空間。在有些應用程式中,由于應用程式中的對象與ADO中的對象之間可能會出現命名沖突,是以有必要使用名稱空間。如果要使用名稱空間,則可把第三行程式修改為: rename_namespace("AdoNS")。第四行代碼将ADO中的EOF(檔案結束)更名為adoEOF,以避免與定義了自己的EOF的其他庫沖突。
2、初始化COM環境
(1)::CoInitialize(NULL); //初始化OLE/COM庫環境
:: CoUninitialize();//既然初始化了環境,當然就有必要釋放他了
(2)也可以調用MFC全局函數
AfxOleInit();
3、三大對象的定義和建立執行個體
(1) _ConnectionPtr pConnection("ADODB.Connection");
_RecordsetPtr pRecordset("ADODB.Recordset");
_CommandPtr pCommand("ADODN.Command");
(2) _ConnectionPtr pConnection;
_RecordsetPtr pRecordset;
_CommandPtr pCommand;
pConnection.CreateInstance(__uuidof(Connection));
pRecordset.CreateInstance(__uuidof(Recordset));
pCommand.CreateInstance(__uuidof(Command));
(3) _ConnectionPtr pConnection;
_RecordsetPtr pRecordset;
_CommandPtr pCommand;
pConnection.CreateInstance("ADODB.Connection");
pRecordset.CreateInstance("ADODB.Recordset");
pCommand.CreateInstance("ADODB.Command");
4、打開一個連接配接
pConnection->Open(ConnectionString,"","",adModeUnknown);///連接配接資料庫
上面的連接配接字元串ConnectionString根據不同的資料源,分别對應不同的寫法
1)通路Access 2000
"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=databaseName;User ID=userName;Password=userPassWord"
2)通路ODBC資料
" Provider=MADASQL;DSN=dsnName;UID=userName;PWD=userPassword;"
3)通路Oracle資料庫
“Provider=MSDAORA;Data Sourse=serverName;User ID=userName;Password=userPassword;"
3)通路MS SQL資料庫
"Provider=SQLOLEDB,Data Source=serverName;Initial Catalog=databaseName;User ID=userName;Password=userPassword;"
4、執行SQL指令
SQL指令比較多,但是不去考慮細節,這裡隻說出通用的方法
CString strSQL;//定義SQL指令串,用來儲存SQL語句
strSQL.Format("SQL statement");
然後在每個要用到SQL指令串的方法中,使用strSQL.AllocSysString()的方法進行類型轉換
5、com的專用資料類型
variant ,bstr ,SafeArray
variant變量的範圍包括很多,使用_variant_t 進行管理
bstr是一種字元串變量,使用_bstr_t進行管理
6、關閉連接配接
if(m_pConnection->State)//不能多次關閉,否則會出現錯誤
m_pConnection->Close();
7、結構化異常處理
ADO封裝了COM接口,是以需要進行錯誤處理
如下例:
HRESULT hr;
try
{
hr = m_pConnection.CreateInstance("ADODB.Connection");///建立Connection對象
if(SUCCEEDED(hr))
{
hr = m_pConnection->Open("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=test.mdb","","",adModeUnknown);///連接配接資料庫
///上面一句中連接配接字串中的Provider是針對ACCESS2000環境的,對于ACCESS97,需要改 為:Provider=Microsoft.Jet.OLEDB.3.51; }
}
catch(_com_error e)///捕捉異常
{
CString errormessage;
errormessage.Format("連接配接資料庫失敗!
錯誤資訊:%s",e.ErrorMessage());
AfxMessageBox(errormessage);///顯示錯誤資訊
}
8、錯誤原因的分析
(1)不支援接口,可能是不能插入空值