上的高級編程接口,因而它兼具有強大的數(shù)據(jù)處理功能(處理各種不同類型的數(shù)據(jù)源、分布式的
數(shù)據(jù)處理等等)和極其簡單、易用的編程接口,因而得到了廣泛的應(yīng)用。而且按微軟公司的意圖
,OLE DB和ADO將逐步取代 ODBC和DAO?,F(xiàn)在介紹ADO各種應(yīng)用的文章和書籍有很多,本文著重站
在初學(xué)者的角度,簡要探討一下在VC++中使用ADO編程時的一些問題。我們希望閱讀本文之前,
您對ADO技術(shù)的基本原理有一些了解。
一、在VC++中使用ADO編程
ADO實際上就是由一組Automation對象構(gòu)成的組件,因此可以象使用其它任何Automation對
象一樣使用ADO。ADO中最重要的對象有三個:Connection、Command和Recordset,它們分別表示
連接對象、命令對象和記錄集對象。如果您熟悉使用MFC中的ODBC類(CDatabase、CRecordset)
編程,那么學(xué)習(xí)ADO編程就十分容易了。
使用ADO編程時可以采用以下三種之一:
1、使用預(yù)處理指令#import
#import "C:\Program Files\Common Files\System\ADO\msado15.dll" \
no_namespace rename("EOF", "EndOfFile")
但要注意不能放在stdAfx.h文件的開頭,而應(yīng)該放在所有include指令的后面。否則在編譯
時會出錯。
程序在編譯過程中,VC++會讀出msado15.dll中的類型庫信息,自動產(chǎn)生兩個該類型庫的頭文件
和實現(xiàn)文件msado15.tlh和msado15.tli(在您的Debug或Release目錄下)。在這兩個文件里定義
了ADO的所有對象和,以及一些枚舉型的常量等。我們的程序只要直接調(diào)用這些就行了
,與使用MFC中的COleDispatchDriver類調(diào)用Automation對象十分類似。
2、使用MFC中的CIDispatchDriver
就是通過讀取msado15.dll中的類型庫信息,建立一個COleDispatchDriver類的派生類,然
后通過它調(diào)用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的控制能力也最強。
據(jù)微軟資料介紹,第一種不支持調(diào)用中的默認(rèn)參數(shù),當(dāng)然第二種也是這樣,但
第三種就不是這樣了。采用第三種的水平也最高。當(dāng)你需要繞過ADO而直接調(diào)用OLE DB底層
的時,就一定要使用第三種了。
ADO編程的關(guān)鍵,就是熟練地運用ADO提供的各種對象(object)、(method)、屬性
(property)和容器(collection)。另外,如果是在MS SQL或Oracle等大型數(shù)據(jù)庫上編程,還要
能熟練使用SQL語言。
二、使用#import的編程步驟
這里建議您使用#import的,因為它易學(xué)、易用,代碼也比較簡潔。
1、 添加#import指令
打開stdafx.h文件,將下列內(nèi)容添加到所有的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++擴展的一些預(yù)處理指令、宏等的定義,用于COM編程時使用。
2、定義_ConnectionPtr型變量,并建立數(shù)據(jù)庫連接
建立了與數(shù)據(jù)庫服務(wù)器的連接后,才能進行其他有關(guān)數(shù)據(jù)庫的訪問和操作。ADO使用
Connection對象來建立與數(shù)據(jù)庫服務(wù)器的連接,所以它相當(dāng)于MFC中的CDatabase類。和
CDatabase類一樣,調(diào)用Connection對象的Open即可建立與服務(wù)器的連接。
數(shù)據(jù)類型 _ConnectionPtr實際上就是由類模板_com_ptr_t而得到的一個具體的實例類,其
定義可以到msado15.tlh、comdef.h 和comip.h這三個文件中找到。在msado15.tlh中有:
_COM_SMARTPTR_TYPEDEF(_Collection, __uuidof(_Collection));
經(jīng)宏擴展后就得到了_ConnectionPtr類。_ConnectionPtr類封裝了Connection對象的
Idispatch接口指針,及一些必要的操作。我們就是通過這個指針來操縱Connection對象。類似
地,后面用到的_CommandPtr和_RecordsetPtr類型也是這樣得到的,它們分別表示命令對象指針
和記錄集對象的指針。
?。?)、連接到MS SQL Server
注意連接字符串的格式,提供正確的連接字符串是成功連接到數(shù)據(jù)庫服務(wù)器的第一步,有關(guān)
連接字符串的詳細信息參見微軟MSDN Library光盤。
本例連接字符串中的server_name,database_name,user_name和password在編程時都應(yīng)該
替換成實際的內(nèi)容。
_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中的連接字符串參數(shù)必須是BSTR或_bstr_t類型。另外,本
例是直接通過OLE DB Provider建立連接,所以無需建立數(shù)據(jù)源。
?。?)、通過ODBC Driver連接到Database Server連接字符串格式與直接用ODBC編程時的差
不多:
_bstr_t strConnect="DSN=datasource_name; Database=database_name; uid=user_name;
pwd=password;";
此時與ODBC編程一樣,必須先建立數(shù)據(jù)源。
3、定義_RecordsetPtr型變量,并打開數(shù)據(jù)集
定義_RecordsetPtr型變量,然后通過它調(diào)用Recordset對象的Open,即可打開一個數(shù)據(jù)
集。所以Recordset對象與MFC中的CRecordset類類似,它也有當(dāng)前記錄、當(dāng)前記錄指針的概念。
如:
_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非常重要,它的第一個參數(shù)可以是一個SQL語句、一個表的名字或
一個命令對象等等;第二個參數(shù)就是前面建立的連接對象的指針。此外,用Connection和
Command對象的Execute也能得到記錄集,但是只讀的。
4、讀取當(dāng)前記錄的數(shù)據(jù)
我認(rèn)為讀取數(shù)據(jù)的最方便的如下:
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變量內(nèi)。例中的
Fields是Recordset對象的容器,GetItem返回的是Field對象,而Value則是Field對象的一
個屬性(即該字段的值)。通過此例,應(yīng)掌握操縱對象屬性的。例如,要獲得Field 對象的
Value屬性的值可以直接用屬性名Value來引用它(如上例),但也可以調(diào)用Get,例如:
CString sName=(char*)(_bstr_t)(m_pRecordset->Fields->GetItem
(_variant_t("name"))->GetValue());
從此例還可以看到,判斷是否到達記錄集的末尾,使用記錄集的adoEOF屬性,其值若為真即
到了結(jié)尾,反之則未到。判斷是否到達記錄集開頭,則可用BOF屬性。
另外,讀取數(shù)據(jù)還有一個,就是定義一個綁定的類,然后通過綁定的變量得到字段值(
詳見后面的介紹)。
5、修改數(shù)據(jù)
一:
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、添加記錄
新記錄添加成功后,即自動成為當(dāng)前記錄。AddNew有兩種形式,一個含有參數(shù),而另一
個則不帶參數(shù)。
一(不帶參數(shù)):
// 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);
}
這種弄完了還要調(diào)用Update()。
二(帶參數(shù)):
_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);
這種不需要調(diào)用Update,因為添加后,ADO會自動調(diào)用它。此主要是使用SafeArray
挺麻煩。
三:就是用定義綁定類的(詳見后面的介紹)。
7、刪除記錄
調(diào)用Recordset的Delete就行了,刪除的是當(dāng)前記錄。要了解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、使用帶參數(shù)的命令
Command對象所代表的就是一個Provider能夠理解的命令,如SQL語句等。使用Command對象
的關(guān)鍵就是把表示命令的語句設(shè)置到CommandText屬性中,然后調(diào)用Command對象的Execute
就行了。一般情況下在命令中無需使用參數(shù),但有時使用參數(shù),可以增加其靈活性和效率。
(1). 建立連接、命令對象和記錄集對象
本例中表示命令的語句就是一個SQL語句(SELECT語句)。SELECT語句中的問號?就代表參數(shù)
,如果要多個參數(shù),就多放幾個問號,每個問號代表一個參數(shù)。
_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
要注意命令對象必須與連接對象關(guān)聯(lián)起來才能起作用,本例中將命令對象的
ActiveConnection屬性設(shè)置為連接對象的指針,即為此目的:
Cmd1->ActiveConnection = Conn1;
(2). 創(chuàng)建參數(shù)對象,并給參數(shù)賦值
// 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 );
用命令對象的來創(chuàng)建一個參數(shù)對象,其中的長度參數(shù)(第三個)如果是固定長度的類型
,就填-1,如果是字符串等可變長度的就填其實際長度。Parameters是命令對象的一個容器,它
的Append就是把創(chuàng)建的參數(shù)對象追加到該容器里。Append進去的參數(shù)按先后順序與SQL語句
中的問號從左至右一一對應(yīng)。
(3). 執(zhí)行命令打開記錄集
// Open Recordset Object
Rs1 = Cmd1->Execute( &vtEmpty, &vtEmpty2, adCmdText );
但要注意,用Command和Connection對象的Execute得到的Recordset是只讀的。因為在
打開Recordset之前,我們無法設(shè)置它的LockType屬性(其默認(rèn)值為只讀)。而在打開之后設(shè)置
LockType不起作用。
我發(fā)現(xiàn)用上述得到記錄集Rs1后,不但Rs1中的記錄無法修改,即使直接用SQL語句修改
同一表中任何記錄都不行。
要想能修改數(shù)據(jù),還是要用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真是太好了,其第一個參數(shù)可以是SQL語句、表名字、命令對象指
針等等。
9、響應(yīng)ADO的通知事件
通知事件就是當(dāng)某個特定事件發(fā)生時,由Provider通知客戶程序,換句話說,就是由
Provider調(diào)用客戶程序中的一個特定的(即事件的處理函數(shù))。所以為了響應(yīng)一個事件,最
關(guān)鍵的就是要實現(xiàn)事件的處理函數(shù)。
(1). 從ConnectionEventsVt接口派生出一個類
為了響應(yīng)_Connection的通知事件,應(yīng)該從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). 實現(xiàn)每一個事件的處理函數(shù)(凡是帶raw_前綴的都把它實現(xiàn)了):
STDMETHODIMP CConnEvent::raw_InfoMessage(
struct Error *pError,
EventStatusEnum *adStatus,
struct _Connection *pConnection)
{
*adStatus = adStatusUnwantedEvent;
return S_OK;
};
有些雖然你并不需要,但也必須實現(xiàn)它,只需簡單地返回一個S_OK即可。但如果要避免
經(jīng)常被調(diào)用,還應(yīng)在其中將adStatus參數(shù)設(shè)置為adStatusUnwantedEvent,則在本次調(diào)用后,以
后就不會被調(diào)用了。
另外還必須實現(xiàn)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). 開始響應(yīng)通知事件
// 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). 停止響應(yīng)通知事件
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;
在連接關(guān)閉之后做這件事。
10、邦定數(shù)據(jù)
定義一個綁定類,將其成員變量綁定到一個指定的記錄集,以方便于訪問記錄集的字段值。
(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宏關(guān)聯(lián)起來。每個字段對應(yīng)于兩個變量
,一個存放字段的值,另一個存放字段的狀態(tài)。字段用從1開始的序號表示,如1,2,3等等。
特別要注意的是:如果要綁定的字段是字符串類型,則對應(yīng)的字符數(shù)組的元素個數(shù)一定要比
字段長度大2(比如m_szau_fname[22],其綁定的字段au_fname的長度實際是20),不這樣綁定
就會失敗。我分析多出的2可能是為了存放字符串結(jié)尾的空字符null和BSTR字符串開頭的一個字
(表示BSTR的長度)。這個問題對于初學(xué)者來說可能是一個意想不到的問題。
CADORecordBinding類的定義在icrsint.h文件里,內(nèi)容是:
class CADORecordBinding
{
public:
STDMETHOD_(const ADO_BINDING_ENTRY*, GetADOBindingEntries) (VOID) PURE;
};
BEGIN_ADO_BINDING宏的定義也在icrsint.h文件里,內(nèi)容是:
#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接口才能綁定,調(diào)用它的BindToRecordset就行
了。
(3). rs中的變量即是當(dāng)前記錄字段的值
//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();
只要字段的狀態(tài)是adFldOK,就可以訪問。如果修改了字段,不要忘了先調(diào)用picRs的Update
(注意不是Recordset的Update),然后才關(guān)閉,也不要忘了釋放picRs(即picRs->Release();
)。
(4). 此時還可以用IADORecordBinding接口添加新紀(jì)錄
if(FAILED(picRs->AddNew(&rs)))
......
11. 訪問長數(shù)據(jù)
在Microsoft SQL中的長數(shù)據(jù)包括text、image等這樣長類型的數(shù)據(jù),作為二進制字節(jié)來對待
。
可以用Field對象的GetChunk和AppendChunk來訪問。每次可以讀出或?qū)懭肴繑?shù)據(jù)的一
部分,它會記住上次訪問的位置。但是如果中間訪問了別的字段后,就又得從頭來了。
請看下面的例子:
//寫入一張照片到數(shù)據(jù)庫:
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();
//從數(shù)據(jù)庫讀一張照片:
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問題
學(xué)會使用SafeArray也是很重要的,因為在ADO編程中經(jīng)常要用。它的主要目的是用于
automation中的數(shù)組型參數(shù)的傳遞。因為在網(wǎng)絡(luò)環(huán)境中,數(shù)組是不能直接傳遞的,而必須將其包
裝成SafeArray。實質(zhì)上SafeArray就是將通常的數(shù)組增加一個描述符,說明其維數(shù)、長度、邊界
、元素類型等信息。SafeArray也并不單獨使用,而是將其再包裝到VARIANT類型的變量中,然后
才作為參數(shù)傳送出去。在VARIANT的vt成員的值如果包含VT_ARRAY│...,那么它所封裝的就是一
個SafeArray,它的parray成員即是指向SafeArray的指針。SafeArray中元素的類型可以是
VARIANT能封裝的任何類型,包括VARIANT類型本身。
使用SafeArray的具體步驟:
一:
包裝一個SafeArray:
(1). 定義變量,如:
VARIANT varChunk;
SAFEARRAY *psa;
SAFEARRAYBOUND rgsabound[1];
(2). 創(chuàng)建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). 放置數(shù)據(jù)元素到SafeArray:
for(long index=0;index<uIsRead;index++)
{
if(FAILED(SafeArrayPutElement(psa,&index,&bVal[index])))
::MessageBox(NULL,"出毛病了。","提示",MB_OK │ MB_ICONWARNING);
}
一個一個地放,挺麻煩的。
(4). 封裝到VARIANT內(nèi):
varChunk.vt = VT_ARRAY│VT_UI1;
varChunk.parray = psa;
這樣就可以將varChunk作為參數(shù)傳送出去了。
讀取SafeArray中的數(shù)據(jù)的步驟:
(1). 用SafeArrayGetElement一個一個地讀
BYTE buf[lIsRead];
for(long index=0;index<lIsRead;index++)
{
::SafeArrayGetElement(varChunk.parray,&index,buf+index);
}
就讀到緩沖區(qū)buf里了。
二:
使用SafeArrayAccessData直接讀寫SafeArray的緩沖區(qū):
(1). 讀緩沖區(qū):
BYTE *buf;
SafeArrayAccessData(varChunk.parray, (void **)&buf);
f.Write(buf,lIsRead);
SafeArrayUnaccessData(varChunk.parray);
(2). 寫緩沖區(qū):
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的數(shù)據(jù)緩沖區(qū),比用
SafeArrayGetElement和SafeArrayPutElement速度快。特別適合于讀取數(shù)據(jù)。但用完之后不要忘
了調(diào)用::SafeArrayUnaccessData(psa),否則會出錯的。
13. 使用書簽( bookmark )
書簽可以唯一標(biāo)識記錄集中的一個記錄,用于快速地將當(dāng)前記錄移回到已訪問過的記錄,以
及進行過濾等等。Provider會自動為記錄集中的每一條記錄產(chǎn)生一個書簽,我們只需要使用它就
行了。我們不能試圖顯示、修改或比較書簽。ADO用記錄集的Bookmark屬性表示當(dāng)前記錄的書簽
。
用法步驟:
(1). 建立一個VARIANT類型的變量
_variant_t VarBookmark;
(2). 將當(dāng)前記錄的書簽值存入該變量
也就是記錄集的Bookmark屬性的當(dāng)前值。
VarBookmark = rst->Bookmark;
(3). 返回到先前的記錄
將保存的書簽值設(shè)置到記錄集的書簽屬性中:
// Check for whether bookmark set for a record
if (VarBookmark.vt == VT_EMPTY)
printf("No Bookmark set!\n");
else
rst->Bookmark = VarBookmark;
設(shè)置完后,當(dāng)前記錄即會移動到該書簽指向的記錄。
14、設(shè)置過濾條件
Recordset對象的Filter屬性表示了當(dāng)前的過濾條件。它的值可以是以AND或OR連接起來的條
件表達式(不含WHERE關(guān)鍵字)、由書簽組成的數(shù)組或ADO提供的FilterGroupEnum枚舉值。為
Filter屬性設(shè)置新值后Recordset的當(dāng)前記錄指針會自動移動到滿足過濾條件的第一個記錄。例
如:
rst->Filter = _bstr_t ("姓名='趙薇' AND 性別=’女’");
在使用條件表達式時應(yīng)注意下列問題:
(1)、可以用圓括號組成復(fù)雜的表達式
例如:
rst->Filter = _bstr_t ("(姓名='趙薇' AND 性別=’女’) OR AGE<25");
但是微軟不允許在括號內(nèi)用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,如果過濾條件是由書簽組成的數(shù)組,則需將該數(shù)組轉(zhuǎn)換為
SafeArray,然后再封裝到一個VARIANT或_variant_t型的變量中,再賦給Filter屬性。
15、索引與排序
(1)、建立索引
當(dāng)以某個字段為關(guān)鍵字用Find查找時,為了加快速度可以以該字段為關(guān)鍵字在記錄集內(nèi)
部臨時建立索引。只要將該字段的Optimize屬性設(shè)置為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中稱為動態(tài)屬性),ADO本身沒有此屬
性。
?。?)、排序
要排序也很簡單,只要把要排序的關(guān)鍵字列表設(shè)置到Recordset對象的Sort屬性里即可,例
如:
pRstAuthors->CursorLocation = adUseClient;
pRstAuthors->Open("SELECT * FROM mytable",
_variant_t((IDispatch *) pConnection),
adOpenStatic, adLockReadOnly, adCmdText);
......
pRst->Sort = "姓名 DESC, 年齡 ASC";
關(guān)鍵字(即字段名)之間用逗號隔開,如果要以某關(guān)鍵字降序排序,則應(yīng)在該關(guān)鍵字后加一
空格,再加DESC(如上例)。升序時ASC加不加無所謂。本操作是利用索引進行的,并未進行物
理排序,所以效率較高。
但要注意,在打開記錄集之前必須將記錄集的CursorLocation屬性設(shè)置為adUseClient,如上例
所示。Sort屬性值在需要時隨時可以修改。
16、事務(wù)處理
ADO中的事務(wù)處理也很簡單,只需分別在適當(dāng)?shù)奈恢谜{(diào)用Connection對象的三個即可,
這三個是:
?。?)、在事務(wù)開始時調(diào)用
pCnn->BeginTrans();
?。?)、在事務(wù)結(jié)束并成功時調(diào)用
pCnn->CommitTrans ();
?。?)、在事務(wù)結(jié)束并失敗時調(diào)用
pCnn->RollbackTrans ();
在使用事務(wù)處理時,應(yīng)盡量減小事務(wù)的范圍,即減小從事務(wù)開始到結(jié)束(提交或回滾)之間
的時間間隔,以便提高系統(tǒng)效率。需要時也可在調(diào)用BeginTrans()之前,先設(shè)置Connection
對象的IsolationLevel屬性值,詳細內(nèi)容參見MSDN中有關(guān)ADO的技術(shù)資料。
三、使用ADO編程常見問題解答
以下均是針對MS SQL 7.0編程時所遇問題進行討論。
1、連接失敗可能原因
Enterprise Managemer內(nèi),打開將服務(wù)器的屬性對話框,在Security選項卡中,有一個選項
Authentication。
如果該選項是Windows NT only,則你的程序所用的連接字符串就一定要包含
Trusted_Connection參數(shù),并且其值必須為yes,如:
"Provider=SQLOLEDB;Server=888;Trusted_Connection=yes"
";Database=master;uid=lad;";
如果不按上述操作,程序運行時連接必然失敗。
如果Authentication選項是SQL Server and Windows NT,則你的程序所用的連接字符串可
以不包含Trusted_Connection參數(shù),如:
"Provider=SQLOLEDB;Server=888;Database=master;uid=lad;pwd=111;";
因為ADO給該參數(shù)取的默認(rèn)值就是no,所以可以省略。我認(rèn)為還是取默認(rèn)值比較安全一些。
2、改變當(dāng)前數(shù)據(jù)庫的
使用Tansct-SQL中的USE語句即可。
3、如何判斷一個數(shù)據(jù)庫是否存在
(1)、可打開master數(shù)據(jù)庫中一個叫做SCHEMATA的視圖,其內(nèi)容列出了該服務(wù)器上所有的數(shù)
據(jù)庫名稱。
(2) 、更簡便的是使用USE語句,成功了就存在;不成功,就不存在。例如:
try{
m_pConnect->Execute ( _bstr_t("USE INSURANCE_2002"),NULL,
adCmdText│adExecuteNoRecords );
}
catch (_com_error &e)
{
blSuccess=FALSE;
CString str="數(shù)據(jù)庫INSURANCE_2002不存在!\n";
str+=e.Description();
::MessageBox(NULL,str,"警告",MB_OK │ MB_ICONWARNING);
}
4、判斷一個表是否存在
?。?)、同樣判斷一個表是否存在,也可以用是否成功地打開它來判斷,十分方便,例如:
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服務(wù)器上的每個數(shù)據(jù)庫中都有一個名
為sysobjects的表,查看此表的內(nèi)容即知指定的表是否在該數(shù)據(jù)庫中。
(3)、同樣,每個數(shù)據(jù)庫中都有一個名為TABLES的視圖(View),查看此視圖的內(nèi)容即知指定
的表是否在該數(shù)據(jù)庫中。
5、類型轉(zhuǎn)換問題
(1)、類型VARIANT_BOOL
類型VARIANT_BOOL等價于short類型。The VARIANT_BOOL is equivalent to short. see
it's definition below:
typdef short VARIANT_BOOL
?。?)、_com_ptr_t類的類型轉(zhuǎn)換
_ConnectionPtr可以自動轉(zhuǎn)換成IDspatch*類型,這是因為_ConnectionPtr實際上是
_com_ptr_t類的一個實例,而這個類有此類型轉(zhuǎn)換函數(shù)。
同理,_RecordsetPtr和_CommandPtr也都可以這樣轉(zhuǎn)換。
?。?)、_bstr_t和_variant_t類
在ADO編程時,_bstr_t和_variant_t這兩個類很有用,省去了許多BSTR和VARIANT類型轉(zhuǎn)換
的麻煩。
6、打開記錄集時的問題
在打開記錄集時,在調(diào)用Recordset的Open時,其最后一個參數(shù)里一定不能包含
adAsyncExecute,否則將因為是異步操作,在讀取數(shù)據(jù)時無法讀到數(shù)據(jù)。
7、異常處理問題
對所有調(diào)用ADO的語句一定要用try和catch語句捕捉異常,否則在發(fā)生異常時,程序會異常
退出。
8、使用SafeArray問題
在初學(xué)使用中,我曾遇到一個傷腦筋的問題,一定要注意:
在定義了SAFEARRAY的指針后,如果打算重復(fù)使用多次,則在中間可以調(diào)
用::SafeArrayDestroyData釋放數(shù)據(jù),但決不能調(diào)用::SafeArrayDestroyDescriptor,否則必然
出錯,即使調(diào)用SafeArrayCreate也不行。例如:
SAFEARRAY *psa;
......
//When the data are no longer to be used:
::SafeArrayDestroyData( psa);
我分析在定義psa指針時,一個SAFEARRAY的實例(也就是SAFEARRAY描述符)也同時被自動
建立了。但是只要一調(diào)用::SafeArrayDestroyDescriptor,描述符就被銷毀了。
所以我認(rèn)為::SafeArrayDestroyDescriptor可以根本就不調(diào)用,即使調(diào)用也必須在最后調(diào)用
。
9、重復(fù)使用命令對象問題
一個命令對象如果要重復(fù)使用多次(尤其是帶參數(shù)的命令),則在第一次執(zhí)行之前,應(yīng)將它
的Prepared屬性設(shè)置為TRUE。這樣會使第一次執(zhí)行減慢,但卻可以使以后的執(zhí)行全部加快。
10、綁定字符串型字段問題
如果要綁定的字段是字符串類型,則對應(yīng)的字符數(shù)組的元素個數(shù)一定要比字段長度大2(比
如m_szau_fname[22],其綁定的字段au_fname的長度實際是20),不這樣綁定就會失敗。
11、使用AppendChunk的問題
當(dāng)用AddNew剛剛向記錄集內(nèi)添加一個新記錄之后,不能首先向一個長數(shù)據(jù)字段(image
類型)寫入數(shù)據(jù),必須先向其他字段寫入過數(shù)據(jù)之后,才能調(diào)用AppendChunk寫該字段,否則出
錯。也就是說,AppendChunk不能緊接在AddNew之后。另外,寫入其他字段后還必須緊接著調(diào)用
AppendChunk,而不能調(diào)用記錄集的Update后,才調(diào)用AppendChunk,否則調(diào)用AppendChunk
時也會出錯。換句話說,就是必須AppendChunk在前,Update在后。因而這個時候就不能使用帶
參數(shù)的AddNew了,因為帶參數(shù)的AddNew會自動調(diào)用記錄集的Update,所以AppendChunk就跑到
Update的后面了,就只有出錯了!因此,這時應(yīng)該用不帶參數(shù)的AddNew。
我推測這可能是MS SQL 7.0的問題,在MS SQL 2000中則不存在這些問題,但是AppendChunk
仍然不能在Update之后。
四、小結(jié)
一般情況下,Connection和Command的Execute用于執(zhí)行不產(chǎn)生記錄集的命令,而Recordset
的Open用于產(chǎn)生一個記錄集,當(dāng)然也不是絕對的。特別Command主要是用于執(zhí)行參數(shù)化的命令,
可以直接由Command對象執(zhí)行,也可以將Command對象傳遞給Recordset的Open。
本文中的代碼片斷均在VC++ 6.0、Windows NT 4.0 SP6和MS SQL 7.0中調(diào)試通過。相信您讀
過之后,編寫簡單的數(shù)據(jù)庫程序應(yīng)該沒有問題了。當(dāng)然要編寫比較實用的、復(fù)雜一點的程序,還
需要對OLE DB、ADO以及數(shù)據(jù)庫平臺再多了解一點,希望您繼續(xù)努力,一定會很快成功的!詳細
參考資料請參見微軟MSDN July 2000光盤或MS SQL 7.0在線文檔資料(Books online)。文中難
免有錯誤和不妥之處,敬請各位批評指正!
聯(lián)系客服