ADO数据库链接

一、数据库操作准备

// ---------------------------------------------------------------------------------------------------------------------------------

1、导入ADO动态链接库

　　在工程的stdafx.h中加入如下语句：

　　#import "C:\Program Files\Common Files\System\ado\msado15.dll"\

　　no_namespace   rename("EOF", "adoEOF")

　　这一语句有何作用呢？

　　其最终作用同我们熟悉的 #include 类似，编译的时候系统会为我们生成msado15.tlh和ado15.tli两个C++头文件来定义ADO库，

　　即加载ADO动态库(msado15.dll)。

　　其中，no_namespace表明不使用命名空间，rename("EOF","adoEOF")表明把ADO中用到的EOF改为adoEOF，防止发生命名冲突。

　　注意：

　　　　该代码需要在一行中完成，如果写成两行或者多行，行末要加上“\”符号，表示把这几行看成一行，如本例。

// ---------------------------------------------------------------------------------------------------------------------------------

2、初始化OLE/COM库环境

　　在基于MFC的应用中初始化OLE/COM库环境的一个比较好的位置，是在应用程序类CXXXApp的InitInstance成员函数中直接调用AfxOleInit()，

　　而在退出应用时该函数也负责COM资源的释放，将此函数添加在InitInstance中的如下位置：

BOOL CExpApp::InitInstance()

 {         

　　AfxEnableControlContainer();                

　　// 初始化OLE DLL
　　if (!AfxOleInit())
　　{
　　　　AfxMessageBox(_T("初始化OLE DLL失败!"));
　　　　return FALSE;
　　}        

　　// 其他操作...

 }

说明：

　　也可以在InitInstance中使用::CoInitialize初始化OLE/COM库环境，

　　 但须在ExitInitInstance中使用::CoUninitialize释放占用的COM资源。

　　比较之下，显然是使用AfxOleInit更为方便。

// ---------------------------------------------------------------------------------------------------------------------------------

3、连接数据库

　　在Doc\View程序中，通常在应用程序类（CXXXApp）中进行数据库的连接。

　　具体操作如下：

　　1）声明一个Connection指针

　　　　_ConnectionPtr m_pConnection;

　　　　注：

　　　　　　ADO最重要的对象有三个：

　　　　　　连接对象（Connection）、命令对象（Command）和记录集对象（RecordSet）。

　　　　　　在使用这三个对象的时候，需要定义与之相对应的智能指针，分别为_ConnectionPtr、_CommandPtr、_RecordsetPtr。

　　　　　　由上述ConnectionPtr指针的使用步骤可知，和C++中的类指针使用方法一样，智能指针也要先定义指针变量、

　　　　　　创建其实例（实例化），然后就可以调用它的方法和属性。 不同的是，该智能指针最后是自动进行内存释放的。

　　　　　　所有的智能指针都是基于_com_ptr_t模板类的，该类封装了IUnknow接口的3个方法：QueryInterface、Addref和Release。

　　　　　　它具有自动计数的机制，即在构造对象时，自动为该对象计数加1。析构对象时，自动调用Release方法。

　　　　　　（即该类型的指针在使用后不需要手动释放内存）（但需要调用Close方法，关闭连接或者记录集）

　　　　　　所以智能指针会使代码更加简洁并且不易出错。

　　2）创建Connection对象

　　　　方法有如下两种：

　　　　　　　　m_pConnection.CreateInstance(__uuidof(Connection));

　　　　　　　　m_pConnection.CreateInstance("ADODB.Connection");

　　　　 注意：

　　　　　　　　上面调用_ConnectionPtr接口指针的方法CreateInstance时，用的是"."而非"->"。

　　3）设置连接字符串，以便指定需要的连接

　　　　对应不同的数据库，其连接字库串有所不同：

　　　　 3.1) 使用JET数据库引擎实现对Acess2000类型的数据库info.mdb的连接

CString strSQ L= "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=info.mdb;User ID=admin;Passward=;";

　　　　或者

　　　　　　　CString strSQL = _T("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=info.mdb;User ID=admin;Passward=;");

　　　　3.2) 使用OLE DB提供者实现对SQL Server的标准安全连接串

　　　　　　 strConnect = _T("Provider=SQLOLEDB;Data Source=MyServerName;\

　　　　　　　　　　　　　　Initial Catalog=MyDateBaseName;\

　　　　　　　　　　　　　　User ID=MyUserName;Password=MyPassword;");

　　　　  或者

　　　　　　strConnect = _T("Provider=SQLOLEDB;Server=MyServerName;\

　　　　　　　　　　　　　　Database=MyDateBaseName;\

　　　　　　　　　　　　　　Uid=MyUserName;Pwd=MyPassword;");

例程：

　　　　　　_bstr_t strConnect("Provider=SQLOLEDB;Server=MYSERVER;Database=MYDATADABE;Uid=sa;Pwd=12345678;");

　　　　　　m_pConnection->Open((_bstr_t)strSQL,"","",adModeUnknown);

或者, 是在此处不设置User ID和Password，而直接在Open函数的第2、3个参数中设置，这也可以。

　　 _bstr_t strConnect("Provider=SQLOLEDB;Server=MYSERVER;Database=MYDATADABE;");

　　　　　　m_pConnection->Open((_bstr_t)strSQL,"sa","12345678",adModeUnknown);

　　　　注意：

　　　　　　上面设置连接字符串的时候，如果过长需要分行时，可用反斜杠"\"。

　　　　　　 如果是本地服务器，则DataSource=local或本地服务器名均可。

　　　　　　若数据库没有设置密码，在连接字符串中可以将其省略，但User ID不能省。

　　　　　　若数据库和程序文件不在同一文件夹下，直接写数据库名即可，在InitialCatalog中不需加上该数据库的存储器地址。

　　　　3.3) 使用OLE DB提供者实现对远程SQL Server的标准安全连接串

　　　　　　strConnec t= _T("Provider=sqloledb;Network Library=DBMSSOCN;\

　　　　　　　　　　　　　　Data Source=130.120.110.001,1433;

　　　　　　　　　　　　　　Initial Catalog=MyDateBaseName;

　　　　　　　　　　　　　　User ID=MyUserName;Password=MyPassword;");

　　 4）、使用m_pConnection的Open方法实现对数据库的连接

在ADO的操作中建议使用 try...catch( )来捕获错误信息，因为它有时会经常出现一些意想不到的错误

try
{
    m_pConnection-> //...
    m_pRecordSet->    //...
}
catch(_com_error e)    //捕捉异常
{
    CString strError;
    strError.Format( "连接数据库发生异常! \r \n错误信息:%s", e.ErrorMessage( ) );  

    //显示错误信息
    AfxMessageBox(errormessage);
}

// ---------------------------------------------------------------------------------------------------------------------------------

4、关闭连接

　　一般重载App类的ExitInstace( )函数实现。

　　调用m_pConnection的Close方法关闭连接即可。

　　代码如下：

m_pConnection->Close( );

　　　　m_pConnection=NULL;

注意：

　　　　由于初始化COM库调用的是AfxOleInit，这种方法初始化COM库的优点就在于资源的释放也是自动进行的，所以不必担心资源泄漏的问题。

二、数据库操作 ADO库中包含的三个基本接口为： _ConnectionPtr接口、_CommandPtr接口、_RecordsetPtr接口。

// ---------------------------------------------------------------------------------------------------------------------------------
1、_ConnectionPtr接口

　　 该接口返回一个记录集或一个空指针。

　　 通常用它来创建一个数据库连接，或执行一条不返回任何结果的SQL语句，如一个存储过程。

　　 不推荐使用_ConnectionPtr接口返回一个记录集，对于要返回记录集的操作通常用_RecordsetPtr来实现。

　　 而且使用_ConnectionPtr时要想得到记录数目必须遍历所有记录，但使用_RecordsetPtr时则不需要。

// ---------------------------------------------------------------------------------------------------------------------------------

2、_CommandPtr接口

　　该接口返回一个记录集。

　　它提供了一种简单的方法来执行返回记录集的存储过程和SQL语句。

　　在使用_CommandPtr接口时，可以利用全局_ConnectionPtr接口，也可以在_CommandPtr 接口里直接使用连接串。

　　如果只执行一次或者几次数据库访问操作，后者是比较好的选择。

　　但是，如果频繁访问数据库，并要返回很多记录集，那么应该使用全局_ConnectionPtr接口创建一个数据库连接，然后使用_CommandPtr接口执行存储过程和SQL语句。

// ---------------------------------------------------------------------------------------------------------------------------------

3、_RecordsetPtr接口

　　该接口是一个记录集对象。

　　与前两种对象相比，它对记录集提供了更多的控制功能，如记录锁定、游标控制等。

　　同_CommandPtr接口一样，它不一定使用一个已经创建的数据库连接，可以用一个连接串代替连接指针赋给_RecordsetPtr的connection成员变量，让它自己创建数据库连接。

　　 如果使用多个记录集，最好的方法是同Command对象一样使用已经创建了数据连接的全局_ConnectionPtr接口，然后使用_RecordsetPtr执行存储过程和SQL语句。

注意：

　　可以使用Recordset对象来执行查询命令，但如果查询或者存储过程是需要参数的，这时就只能使用Command对象。

　　使用Recordset对象操作数据库：

　　 假定已经成功使用Connection对象创建了数据源的连接，连接指针为m_pConnection

　　1）创建记录集

　　 　　_RecordsetPtr    m_pRecordset;     　　　　　　　　　　 // 声明记录集指针

　　　　m_pRecordset.CreateInstance(__uuidof(Recordset)); 　　// 创建记录集

　　或者：                   　　　　　　　　

　　　　_RecordsetPtr    m_pRecordset;      　　　　　　　　　　// 声明记录集指针

　　　　m_pRecordset.CreateInstance("ADODB.Recordset"); 　　// 创建记录集

　　2）打开记录集

　　记录集指针创建完毕后，调用该指针的Open方法打开记录集。

　　该函数声明如下：

　　　　HRESULT Recordset15::Open(const _variant_t & Source,

　　　　　　　　　　　　　　　　　　const _variant_t & ActiveConnection,

　　　　　　　　　　　　　　　　　　enum CursorTypeEnum CursorType,

　　　　　　　　　　　　　　　　　　enum LockTypeEnum LockType,

　　　　　　　　　　　　　　　　　　long Options);

　　　 各个参数的含义如下：

　　　　参数Source：

　　　　　　为_variant_t类型的引用，可以为有效的Command对象、SQL语句、表名、存储过程调用等。

　　　　参数ActiveConnection：

　　　　　　为_variant_t类型的引用，为已经建立好的连接。

　　　　参数CursorType：

　　　　　　用于设置在打开Recordset时提供者应使用的游标类型，它可取CursorTypeEnum 中的任一值，默认值为adOpenForwardOnly。

　　　　 参数 LockType：

　　　　　　用于设置在打开Recordset时提供者应使用的锁定类型，它可取枚举LockTypeEnum中的任一值，默认值为adLockReadOnly。

　　　　 参数 Options：

　　　　　　用于设置获取Source（即Open第一个参数）的方式，其类型long。

 

例程1：

　　 CString strSQL = "select * from mytablename";

　　 m_pRecordset->Open(_variant_t (strSQL),

　　　　　　　　　　　　 m_pConnection.GetInterfacePtr( ),

　　　　　　　　　　　　 adOpenDynamic,

　　　　　　　　　　　　 adLockOptimistic,

　　　　　　　　　　　　 adCmdText);

使用SQL语句作为Open方法的第一个参数Source的值，此时Options为adCmdText

例程2：

　　m_pRecordset->Open(_variant_t ("tbDVDInfo"),

　　　　　　　　　　　　 m_pConnection.GetInterfacePtr( ),

　　　　　　　　　　 　   adOpenDynamic,

　　　　　　　　　　　　adLockOptimistic,

　　　　　　　　　　　　adCmdTable);

直接使用表名作为第一个参数，此时Options应为adCmdTable

　　3）遍历记录集

　　一般在返回记录集时，通常要遍历结果记录集，以便查看或编辑某一条记录，Recoreset指针提供了几个用于实现遍历的方法。

　　注意：

　　　　为了避免发生异常，一般在使用MoveFirst、MovePrev之前，需要使用记录集的指针BOF属性来检测当前的记录集指针是否位于第一条记录之前；

　　　　在使用MoveLast、MoveNext之前需要使用记录集指针的EOF属性来检测当前的记录集指针是否位于最后一条记录之后。

　　4）记录集定位

　　记录集接口类提供了两种定位方法： 绝对定位和书签定位

　　前者通过设置或者获取AbsolutePosition属性即可，其值从1开始，并且当前记录为记录集中第一条记录时等于1

　　对于后者可以通过设置或获取BookMark属性即可。

　　 5）访问记录集

　　读写记录集中某一记录中的一个字段，有具体有两种方法：

　　一：

　　读取操作：

　　　　　　_variant_t   var = m_pResultSet->Fields->GetItem(_variant_t("字段名"))->Value;

　　也可用GetValue方法：

　　　　　　 _variant_t   var = m_pResultSet->Fields->GetItem(_variant_t("字段名"))->GetValue();

　　写入操作：

　　　　　　_variant_t   var = .....   // 初始化

　　　　　　m_pResultSet->Fields->GetItem(_variant_t("字段名"))->Value = var;

　　　　也可用PutValue方法：

　　　　　　m_pResultSet->Fields->GetItem(_variant_t("字段名"))->PutValue(var);

　　二：

　　最简单的方法是直接使用如下语句：

　　读取操作：　　　　

　　　　　　　　_variant_t   var =  m_pRecordset->GetCollect (_variant_t("字段名"));

　　写入操作：

　　　　　　　　_variant_t   var = ...  // 初始化

　　　　　　　　m_pRecordset->PutCollect (_variant_t("字段名"), var);

两个方法的原型：

　　　　　　_variant_t GetCollect(const _variant_t & Index )

　　　　　　 void  PutCollect(const _variant_t & Index, const _variant_t &pvar)

其中：

　　　　　　参数Index可以是字符串表示字段名，也可以是整型，表示字段对应的序号。

　　　　　　pvar表示要写入的变量值。

　　例如：

　　　　_variant_t var;

　　　　var = m_pRentRecordset->GetCollect(_variant_t("ID"));

　　　　var = m_pRentRecordset->GetCollect(long(0));   // 都可以

　　6）记录集更新

　　更新记录集包括添加新的记录、编辑当前记录和删除当前记录

　　 记录集接口指针对这三种操作分别提供了相应的方法

　　添加新的记录：AddNew

　　编辑当前记录：Edit

　　删除当前记录：Delete

　　注意：

　　记录集接口指针针对AddNew以及Edit方法提供了Update方法，用于在数据库中更新新添加或者编辑后的记录。

　　AddNew方法：

　　　　用于添加新纪录（该添加是直接在表的末尾续加的），该方法可以使用参数，在参数中指定要添加的新纪录；　　

　　　　也可以不使用参数，而在后面使用PutCollect方法，并需使用Update函数保存新纪录。

　　Update方法：

　　　　用于保存从调用AddNew方法以来所作的任何更改。

　　 例程：

　　　　//在表的末尾增加新纪录

　　　　m_pRecordset->AddNew();

　　　　 m_pRecordset->PutCollect(_variant_t("姓名"),

　　　　_variant_t(m_strName));

　　　　 m_pRecordset->PutCollect(_variant_t("工作单位"),   _variant_t(m_strComName));

　　　　m_pRecordset->PutCollect(_variant_t("单位地址"),   _variant_t(m_strComAddr));

　　　　//更新数据库-将新纪录存入数据库

　　　　m_pRecordset->Update();

　　7）记录集关闭

　　在对记录集的操作完成后，必须及时关闭记录集。

　　if ( m_pRecordset != NULL )

　　{

　　　　 m_pRecordset ->Close( );

　　　　m_pRecordset =NULL;

　　 }

三、ADO中的数据类型

　　在使用ADO技术操作数据库时，存取变量的数据类型都是COM类型，这就要求经常在COM类型和普通数据类型之间进行类型转换。

　　ADO中特有的数据类型包括以下三种：

　　// ---------------------------------------------------------------------------------------------------------------------------------

　　1、Variant

　　　　 该类型是结构化的数据类型，它包含值成员和数据类型成员。

　　　　Variant可以包含许多其他的数据类型：如Variant、BSTR、Boolean、IDispatch或者IUnknow指针、货币、日期等。

　　　　COM中由_variant_t 类来封装和管理Variant数据类型。

　　　　在使用ADO对象模型操作数据库时，如果对象的某个方法或者属性操作数接受某个值，那么通常表明该值在_variant_t 中传递。

　　注意：

　　　　 在利用ADO对象进行C++数据类型的相关数据库操作（如将CString类型的值添加到数据库）时，需要进行强制类型转换

　　例如：

　　　　对于　　CString m_strName;

　　　　　　　　 m_pRecordset->PutCollect("姓名", _variant_t(m_strName));

　　// ---------------------------------------------------------------------------------------------------------------------------------

　　2、BSTR

　　 该类型 ( Basic STRing )也是结构化的数据类型，它包含字符串和字符串的长度。

　　 COM提供分配、处理和释放BSTR的方法，由_bstr_t类来封装和管理BSTR数据类型

　　　在使用ADO对象模型操作数据库时，如果对象的某个方法或者属性操作数接受一个字符串值，那么通常表明该值的形式为_bstr_t，而非一般的CString。

　　// ---------------------------------------------------------------------------------------------------------------------------------

　　3、SafeArray         同样是一种结构化的数据类型，包含其它数据类型的数组。

　　在使用ADO对象模型操作数据库时，如果对象的某个方法或者属性操作数接受或者返回一个数组，则数组类型只能是SafeArray，而非通常意义上的C/C++数组。

　　通常，从数据库中取出的字段值大都在_variant_t中传递，下面给出从COM类型Variant向CString类型转换的通用函数。

　　该函数将为数据库的访问和操作提供极大便利。

 1 CString    CLeftTreeView::VariantToCString(const _variant_t &var)
 2 {
 3     CString strValue;
 4     switch (var.vt)
 5     {
 6     case VT_BSTR:    //字符串
 7     case VT_LPSTR:
 8     case VT_LPWSTR:
 9         strValue = (LPCTSTR)(_bstr_t)var;
10         break;
11     case VT_I1:        //无符号字符
12     case VT_UI1:
13         strValue.Format("%d", var.bVal);
14         break;
15     case VT_I2:        //短整型
16         strValue.Format("%d", var.iVal);
17         break;
18     case VT_UI2:    //无符号短整型
19          strValue.Format("%d", var.uiVal);
20          break;
21     case VT_INT:    //整型
22         strValue.Format("%d", var.intVal);
23         break;
24     case VT_I4:        //整型
25     case VT_I8:        //长整型
26         strValue.Format("%d", var.lVal);
27         break;
28     case VT_UINT:    //无符号整型
29         strValue.Format("%d", var.uintVal);
30         break;
31     case VT_UI4:    //无符号整型
32     case VT_UI8:    //无符号长整型
33         strValue.Format("%d", var.ulVal);
34         break;
35     case VT_VOID:
36         strValue.Format("%8x", var.byref);
37         break;
38     case VT_R4:        //浮点型
39         strValue.Format("%.4f", var.fltVal);
40         break;
41     case VT_R8:        //双精度型
42         strValue.Format("%.8f", var.dblVal);
43         break;
44     case VT_DECIMAL://小数
45         strValue.Format("%.8f", (double)var);
46         break;
47     case VT_CY:
48         {
49             COleCurrency cy = var.cyVal;
50             strValue = cy.Format();
51         }
52         break;
53     case VT_BLOB:
54     case VT_BLOB_OBJECT:
55     case 0x2011:
56         strValue = "[BLOB]";
57         break;
58     case VT_BOOL:    //布尔型
59         strValue = var.boolVal ? "TRUE" : "FALSE";
60         break;
61     case VT_DATE:    //日期型
62         {
63             DATE dt = var.date;
64             COleDateTime da = COleDateTime(dt);
65             strValue = da.Format("%Y-%m-%d %H:%M:%S");
66         }
67         break;
68     case VT_NULL:    //NULL值
69     case VT_EMPTY:    //空
70         strValue = "";
71         break;
72     case VT_UNKNOWN://未知类型
73     default:
74         strValue = "UN_KNOW";
75          break;
76     }
77     return strValue;
78 }