Visual C++ ADO資料庫編程入門（上）

 

　　ADO 是目前在Windows環境中比較流行的用戶端資料庫編程技術。ADO是建立在OLE DB底層技術之上的進階編程介面，因而它兼具有強大的資料處理功能（處理各種不同類型的資料來源、分布式的資料處理等等）和極其簡單、易用的編程介面，因而得到了廣泛的應用。而且按微軟公司的意圖，OLE DB和ADO將逐步取代 ODBC和DAO。現在介紹ADO各種應用的文章和書籍有很多，本文著重站在初學者的角度，簡要探討一下在VC++中使用ADO編程時的一些問題。我們希望閱讀本文之前，您對ADO技術的基本原理有一些瞭解。

　　一、在VC++中使用ADO編程

　　ADO實際上就是由一組Automation對象構成的組件，因此可以象使用其它任何Automation對象一樣使用ADO。ADO中最重要的對象有三個：Connection、Command和Recordset，它們分別表示連線物件、命令對象和記錄集對象。如果您熟悉使用MFC中的ODBC類（CDatabase、CRecordset)編程，那麼學習ADO編程就十分容易了。

　　使用ADO編程時可以採用以下三種方法之一：

　　1、使用預先處理指令#import

#import "C:/Program Files/Common Files/System/ADO/msado15.dll" / no_namespace rename("EOF", "EndOfFile")

　　但要注意不能放在stdAfx.h檔案的開頭，而應該放在所有include指令的後面。否則在編譯時間會出錯。
程式在編譯過程中，VC++會讀出msado15.dll中的類型庫資訊，自動產生兩個該類型庫的標頭檔和實現檔案msado15.tlh和msado15.tli（在您的Debug或Release目錄下）。在這兩個檔案裡定義了ADO的所有對象和方法，以及一些枚舉型的常量等。我們的程式只要直接調用這些方法就行了，與使用MFC中的COleDispatchDriver類調用Automation對象十分類似。

　　2、使用MFC中的CIDispatchDriver

　　就是通過讀取msado15.dll中的類型庫資訊，建立一個COleDispatchDriver類的衍生類別，然後通過它調用ADO對象。

　　3、直接用COM提供的API

　　如使用如下代碼：

CLSID clsid; HRESULT hr = ::CLSIDFromProgID(L"ADODB.Connection", &clsid); if(FAILED(hr)) {...} ::CoCreateInstance(clsid, NULL, CLSCTX_SERVER, IID_IDispatch, (void **) &pDispatch); if(FAILED(hr)) {...}

　　以上三種方法，第一和第二種類似，可能第一種好用一些，第三種編程可能最麻煩。但可能第三種方法也是效率最高的，程式的尺寸也最小，並且對ADO的控制能力也最強。

　　據微軟資料介紹，第一種方法不支援方法調用中的預設參數，當然第二種方法也是這樣，但第三種就不是這樣了。採用第三種方法的水平也最高。當你需要繞過ADO而直接調用OLE DB底層的方法時，就一定要使用第三種方法了。

　　ADO編程的關鍵，就是熟練地運用ADO提供的各種對象(object)、方法(method)、屬性(property)和容器（collection）。另外，如果是在MS SQL或Oracle等大型資料庫上編程，還要能熟練使用SQL語言。

　　二、使用#import方法的編程步驟

　　這裡建議您使用#import的方法，因為它易學、易用，代碼也比較簡潔。

　　1、 添加#import指令

　　開啟stdafx.h檔案，將下列內容添加到所有的include指令之後：

#include <icrsint.h> //Include support for VC++ Extensions #import "C:/Program Files/Common Files/System/ADO/msado15.dll" / no_namespace rename("EOF", "adoEOF")

　　其中icrsint.h檔案包含了VC++擴充的一些預先處理指令、宏等的定義，用於COM編程時使用。

　　2、定義_ConnectionPtr型變數，並建立資料庫連接

　　建立了與資料庫伺服器的串連後，才能進行其他有關資料庫的訪問和操作。ADO使用Connection對象來建立與資料庫伺服器的串連，所以它相當於MFC中的CDatabase類。和CDatabase類一樣，調用Connection對象的Open方法即可建立與伺服器的串連。

　　資料類型 _ConnectionPtr實際上就是由類模板_com_ptr_t而得到的一個具體的執行個體類，其定義可以到msado15.tlh、comdef.h 和comip.h這三個檔案中找到。在msado15.tlh中有：

_COM_SMARTPTR_TYPEDEF(_Collection, __uuidof(_Collection));

　　經宏擴充後就得到了_ConnectionPtr類。_ConnectionPtr類封裝了Connection對象的Idispatch介面指標，及一些必要的操作。我們就是通過這個指標來操縱Connection對象。類似地，後面用到的_CommandPtr和_RecordsetPtr類型也是這樣得到的，它們分別表示命令對象指標和記錄集對象的指標。

　　（1）、串連到MS SQL Server

　　注意連接字串的格式，提供正確的連接字串是成功串連到資料庫伺服器的第一步，有關連接字串的詳細資料參見微軟MSDN Library光碟片。

　　本例連接字串中的server_name，database_name，user_name和password在編程時都應該替換成實際的內容。

_ConnectionPtr pMyConnect=NULL; HRESULT hr=pMyConnect.CreateInstance(__uuidof(Connection))); if(FAILED(hr))return; _bstr_t strConnect="Provider=SQLOLEDB; Server=server_name;" "Database=database_name; uid=user_name; pwd=password;"; //connecting to the database server now: try{pMyConnect->Open(strConnect,"","",NULL);} catch (_com_error &e) { ::MessageBox(NULL,e.Description(),"警告",MB_OK │ MB_ICONWARNING); }

　　注意Connection對象的Open方法中的連接字串參數必須是BSTR或_bstr_t類型。另外，本例是直接通過OLE DB Provider建立串連，所以無需建立資料來源。

　　（2）、通過ODBC Driver串連到Database Server連接字串格式與直接用ODBC編程時的差不多：

_bstr_t strConnect="DSN=datasource_name; Database=database_name; uid=user_name; pwd=password;";

　　此時與ODBC編程一樣，必須先建立資料來源。

　　3、定義_RecordsetPtr型變數，並開啟資料集

　　定義_RecordsetPtr型變數，然後通過它調用Recordset對象的Open方法，即可開啟一個資料集。所以Recordset對象與MFC中的CRecordset類類似，它也有目前記錄、目前記錄指標的概念。如：

_RecordsetPtr m_pRecordset; if(!FAILED(m_pRecordset.CreateInstance( __uuidof( Recordset ))) { m_pDoc->m_initialized=FALSE; return; } try{ m_pRecordset->Open(_variant_t("mytable"), _variant_t((IDispatch *)pMyConnect,true), adOpenKeyset, adLockOptimistic, adCmdTable); } catch (_com_error &e) { ::MessageBox(NULL,"無法開啟mytable表。","提示", MB_OK │ MB_ICONWARNING); }

　　Recordset對象的Open方法非常重要，它的第一個參數可以是一個SQL語句、一個表的名字或一個命令對象等等；第二個參數就是前面建立的連線物件的指標。此外，用Connection和Command對象的Execute方法也能得到記錄集，但是唯讀。

　　4、讀取目前記錄的資料

　　我認為讀取資料的最方便的方法如下：

try{ m_pRecordset->MoveFirst(); while(m_pRecordset->adoEOF==VARIANT_FALSE) { //Retrieve column's value: CString sName=(char*)(_bstr_t)(m_pRecordset->Fields->GetItem (_variant_t("name"))->Value); short cAge=(short)(m_pRecordset->Fields->GetItem (_variant_t("age"))->Value); //Do something what you want to do: ...... m_pRecordset->MoveNext(); } }//try catch (_com_error &e) { CString str=(char*)e.Description(); ::MessageBox(NULL,str+"/n又出毛病了。","提示", MB_OK │ MB_ICONWARNING); }

　　本例中的name和age都是欄位名，讀取的欄位值分別儲存在sName和cAge變數內。例中的Fields是Recordset對象的容器，GetItem方法返回的是Field對象，而Value則是Field對象的一個屬性（即該欄位的值）。通過此例，應掌握操縱對象屬性的方法。例如，要獲得Field 對象的Value屬性的值可以直接用屬性名稱Value來引用它（如上例），但也可以調用Get方法，例如：

CString sName=(char*)(_bstr_t)(m_pRecordset->Fields->GetItem (_variant_t("name"))->GetValue());

　　從此例還可以看到，判斷是否到達記錄集的末尾，使用記錄集的adoEOF屬性，其值若為真即到了結尾，反之則未到。判斷是否到達記錄集開頭，則可用BOF屬性。

　　另外，讀取資料還有一個方法，就是定義一個綁定的類，然後通過綁定的變數得到欄位值（詳見後面的介紹）。

　　5、修改資料

　　方法一：

try{ m_pRecordset->MoveFirst(); while(m_pRecordset->adoEOF==VARIANT_FALSE) { m_pRecordset->Fields->GetItem (_variant_t("姓名"))->Value=_bstr_t("趙薇"); ...... m_pRecordset->Update(); m_pRecordset->MoveNext(); } }//try

　　改變了Value屬性的值，即改變了欄位的值。

　　方法二：

m_pRecordset->Fields->GetItem (_variant_t("姓名"))->PutValue(_bstr_t("趙薇"));

　　方法三：就是用定義綁定類的方法（詳見後面的介紹）。

　　6、添加記錄

　　新記錄添加成功後，即自動成為目前記錄。AddNew方法有兩種形式，一個含有參數，而另一個則不帶參數。

　　方法一（不帶參數）：

// Add new record into this table: try{ if(!m_pRecordset->Supports(adAddNew)) return; m_pRecordset->AddNew(); m_pRecordset->Fields->GetItem (_variant_t("姓名"))->Value=_bstr_t("趙薇"); m_pRecordset->Fields->GetItem (_variant_t("性別"))->Value=_bstr_t("女"); m_pRecordset->Fields->GetItem (_variant_t("age"))->Value=_variant_t((short)20); m_pRecordset->Fields->GetItem (_variant_t("marry"))->Value=_bstr_t("未婚"); m_pRecordset->Update(); }//try catch (_com_error &e) { ::MessageBox(NULL, "又出毛病了。","提示",MB_OK │ MB_ICONWARNING); }

　　這種方法弄完了還要調用Update()。

　　方法二（帶參數）：

_variant_t varName[4],narValue[4]; varName[0] = L"姓名"; varName[1] = L"性別"; varName[2] = L"age"; varName[3] = L"marry"; narValue[0]=_bstr_t("趙薇"); narValue[1]=_bstr_t("女"); narValue[2]=_variant_t((short)20); narValue[3]=_bstr_t("未婚"); const int nCrit = sizeof varName / sizeof varName[0]; // Create SafeArray Bounds and initialize the array SAFEARRAYBOUND rgsaName[1],rgsaValue[1]; rgsaName[0].lLbound = 0; rgsaName[0].cElements = nCrit; SAFEARRAY *psaName = SafeArrayCreate( VT_VARIANT, 1, rgsaName ); rgsaValue[0].lLbound = 0; rgsaValue[0].cElements = nCrit; SAFEARRAY *psaValue = SafeArrayCreate( VT_VARIANT, 1, rgsaValue ); // Set the values for each element of the array HRESULT hr1=S_OK.hr2=S_OK; for( long i = 0 ; i < nCrit && SUCCEEDED( hr1 ) && SUCCEEDED( hr2 );i++) { hr1=SafeArrayPutElement(psaName, &i,&varName[i]); hr2=SafeArrayPutElement(psaValue, &i,&narValue[i]); } // Initialize and fill the SafeArray VARIANT vsaName,vsaValue; vsaName.vt = VT_VARIANT │ VT_ARRAY; vsaValue.vt = VT_VARIANT │ VT_ARRAY; V_ARRAY(&vsaName) = psaName;//&vsaName->parray=psaName; //see definition in oleauto.h file. V_ARRAY(&vsaValue) = psaValue; // Add a new record: m_pRecordset->AddNew(vsaName,vsaValue);

　　這種方法不需要調用Update，因為添加後，ADO會自動調用它。此方法主要是使用SafeArray挺麻煩。

　　方法三：就是用定義綁定類的方法（詳見後面的介紹）。

　7、刪除記錄

　　調用Recordset的Delete方法就行了，刪除的是目前記錄。要瞭解Delete的其它用法請查閱參考文獻。

try{ m_pRecordset->MoveFirst(); while(m_pRecordset->adoEOF==VARIANT_FALSE) { CString sName=(char*)(_bstr_t)(m_pRecordset->Fields->GetItem (_variant_t("姓名"))->Value); if(::MessageBox(NULL,"姓名="+sName+"/n刪除她嗎？", "提示",MB_YESNO │ MB_ICONWARNING)==IDYES) { m_pRecordset->Delete(adAffectCurrent); m_pRecordset->Update(); } m_pRecordset->MoveNext(); } }//try catch (_com_error &e) { ::MessageBox(NULL,"又出毛病了。","提示",MB_OK │ MB_ICONWARNING); }

　　8、使用帶參數的命令

　　Command對象所代表的就是一個Provider能夠理解的命令，如SQL語句等。使用Command對象的關鍵就是把表示命令的語句設定到CommandText屬性中，然後調用Command對象的Execute方法就行了。一般情況下在命令中無需使用參數，但有時使用參數，可以增加其靈活性和效率。

　　(1). 建立串連、命令對象和記錄集對象

　　本例中表示命令的語句就是一個SQL語句（SELECT語句）。SELECT語句中的問號?就代表參數，如果要多個參數，就多放幾個問號，每個問號代表一個參數。

_ConnectionPtr Conn1; _CommandPtr Cmd1; ParametersPtr *Params1 = NULL; // Not an instance of a smart pointer. _ParameterPtr Param1; _RecordsetPtr Rs1; try { // Create Connection Object (1.5 Version) Conn1.CreateInstance( __uuidof( Connection ) ); Conn1->ConnectionString = bstrConnect; Conn1->Open( bstrEmpty, bstrEmpty, bstrEmpty, -1 ); // Create Command Object Cmd1.CreateInstance( __uuidof( Command ) ); Cmd1->ActiveConnection = Conn1; Cmd1->CommandText = _bstr_t("SELECT * FROM mytable WHERE age< ?"); }//try

　　要注意命令對象必須與連線物件關聯起來才能起作用，本例中將命令對象的ActiveConnection屬性設定為連線物件的指標，即為此目的：

Cmd1->ActiveConnection = Conn1;

　　(2). 建立參數對象，並給參數賦值

// Create Parameter Object Param1 = Cmd1->CreateParameter( _bstr_t(bstrEmpty), adInteger, adParamInput, -1, _variant_t( (long) 5) ); Param1->Value = _variant_t( (long) 5 ); Cmd1->Parameters->Append( Param1 );

　　用命令對象的方法來建立一個參數對象，其中的長度參數（第三個）如果是固定長度的類型，就填-1，如果是字串等可變長度的就填其實際長度。Parameters是命令對象的一個容器，它的Append方法就是把建立的參數對象追加到該容器裡。Append進去的參數按先後順序與SQL語句中的問號從左至右一一對應。

　　(3). 執行命令開啟記錄集

// Open Recordset Object Rs1 = Cmd1->Execute( &vtEmpty, &vtEmpty2, adCmdText );

　　但要注意，用Command和Connection對象的Execute方法得到的Recordset是唯讀。因為在開啟Recordset之前，我們無法設定它的LockType屬性（其預設值為唯讀）。而在開啟之後設定LockType不起作用。

　　我發現用上述方法得到記錄集Rs1後，不但Rs1中的記錄無法修改，即使直接用SQL語句修改同一表中任何記錄都不行。

　　要想能修改資料，還是要用Recordset自己的Open方法才行，如：

try{ m_pRecordset->Open((IDispatch *) Cmd1, vtMissing, adOpenStatic, adLockOptimistic, adCmdUnspecified); } catch (_com_error &e) { ::MessageBox(NULL,"mytable表不存在。","提示",MB_OK │ MB_ICONWARNING); }

　　Recordset對象的Open方法真是太好了，其第一個參數可以是SQL語句、表名字、命令對象指標等等。

　　9、響應ADO的通知事件

　　通知事件就是當某個特定事件發生時，由Provider通知客戶程式，換句話說，就是由Provider調用客戶程式中的一個特定的方法（即事件的處理函數）。所以為了響應一個事件，最關鍵的就是要實現事件的處理函數。

　　(1). 從ConnectionEventsVt介面派生出一個類

　　為了響應_Connection的通知事件，應該從ConnectionEventsVt介面派生出一個類：

class CConnEvent : public ConnectionEventsVt { private: ULONG m_cRef; public: CConnEvent() { m_cRef = 0; }; ~CConnEvent() {}; STDMETHODIMP QueryInterface(REFIID riid, void ** ppv); STDMETHODIMP_(ULONG) AddRef(void); STDMETHODIMP_(ULONG) Release(void); STDMETHODIMP raw_InfoMessage( struct Error *pError, EventStatusEnum *adStatus, struct _Connection *pConnection); STDMETHODIMP raw_BeginTransComplete( LONG TransactionLevel, struct Error *pError, EventStatusEnum *adStatus, struct _Connection *pConnection); ...... };

　　　(2). 實現每一個事件的處理函數(凡是帶raw_首碼的方法都把它實現了)：

STDMETHODIMP CConnEvent::raw_InfoMessage( struct Error *pError, EventStatusEnum *adStatus, struct _Connection *pConnection) { *adStatus = adStatusUnwantedEvent; return S_OK; };

　　有些方法雖然你並不需要，但也必須實現它，只需簡單地返回一個S_OK即可。但如果要避免經常被調用，還應在其中將adStatus參數設定為adStatusUnwantedEvent，則在本次調用後，以後就不會被調用了。
另外還必須實現QueryInterface, AddRef, 和Release三個方法:

STDMETHODIMP CConnEvent::QueryInterface(REFIID riid, void ** ppv) { *ppv = NULL; if (riid == __uuidof(IUnknown) ││ riid == __uuidof(ConnectionEventsVt)) *ppv = this; if (*ppv == NULL) return ResultFromScode(E_NOINTERFACE); AddRef(); return NOERROR; } STDMETHODIMP_(ULONG) CConnEvent::AddRef() { return ++m_cRef; }; STDMETHODIMP_(ULONG) CConnEvent::Release() { if (0 != --m_cRef) return m_cRef; delete this; return 0; }

　　(3). 開始響應通知事件

// Start using the Connection events IConnectionPointContainer *pCPC = NULL; IConnectionPoint *pCP = NULL; hr = pConn.CreateInstance(__uuidof(Connection)); if (FAILED(hr)) return; hr = pConn->QueryInterface(__uuidof(IConnectionPointContainer), (void **)&pCPC); if (FAILED(hr)) return; hr = pCPC->FindConnectionPoint(__uuidof(ConnectionEvents), &pCP); pCPC->Release(); if (FAILED(hr)) return; pConnEvent = new CConnEvent(); hr = pConnEvent->QueryInterface(__uuidof(IUnknown), (void **) &pUnk); if (FAILED(hr)) return rc; hr = pCP->Advise(pUnk, &dwConnEvt); pCP->Release(); if (FAILED(hr)) return; pConn->Open("dsn=Pubs;", "sa", "", adConnectUnspecified);

　　也就是說在串連(Open)之前就做這些事。

　　(4). 停止回應通知事件

pConn->Close(); // Stop using the Connection events hr = pConn->QueryInterface(__uuidof(IConnectionPointContainer), (void **) &pCPC); if (FAILED(hr)) return; hr = pCPC->FindConnectionPoint(__uuidof(ConnectionEvents), &pCP); pCPC->Release(); if (FAILED(hr)) return rc; hr = pCP->Unadvise( dwConnEvt ); pCP->Release(); if (FAILED(hr)) return;

　　在串連關閉之後做這件事。