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 }
