企业官网建设流程全解析

简介：这份面向VC++开发者的ADO实例包，围绕Command对象在数据库访问中的实际用法展开，适合已掌握Connection基础连接、希望进一步理解存储过程调用与参数化查询的读者对照学习。包内共11个文件，以3个cpp源文件和3个h头文件为核心，配合vcxproj、sln、filters等Visual Studio工程配置，另有1个txt说明，压缩包约8KB，结构精简，便于直接打开解决方案梳理代码组织。示例工程TestAdo覆盖Command对象的创建与初始化、ActiveConnection与CommandText属性设置、CommandType选择，以及通过Parameters集合追加输入参数、调用存储过程、使用Execute获取结果集或影响行数等环节，并包含异常处理思路。读者可编译运行后逐段对照，理解VC++环境下ADO命令执行的完整链路，也可将其作为小型数据库操作范例迁移到自己的项目中。目前已有528人学习，适合用作入门后的实战参考。

1. 从 Connection 到 Command：Ado 实例里最该先拆的那个对象

VC++Ado 的实例代码里，Connection 往往先被写出来，真正决定数据访问层是否好维护的却是 Command 对象。_CommandPtr 把 SQL 文本、存储过程、参数集合和返回记录集收在一个对象里，适合做参数化查询、批量更新和带输出参数的存储过程调用。它不负责建立连接，也不负责遍历结果，但把“执行什么、带什么参数、返回什么”这件事说清楚了。对正在维护 VC++ 老项目、又不想把 SQL 拼接散落在各处的开发者，这份 Ado 实例的价值就在这里：先把 Command 的对象模型和生命周期拆明白，再谈封装和复用。适合已经能连上数据库、但参数化查询和存储过程调用总是写不顺的人。

2. 接入 _CommandPtr：从 #import 到 COM 初始化的最小闭环

2.1 Command 对象在 ADO 里的位置：不是连接，也不是结果集

ADO 的对象模型里，Connection 管连接，Command 管命令，Parameter 管参数，Recordset 管结果。很多 VC++Ado 代码把 SQL 直接塞进Connection::Execute，短脚本能跑，一旦遇到带参数的分页查询、存储过程输出参数、事务里的多条更新，就会开始散：SQL 字符串拼接、参数顺序靠人工记、错误处理到处复制。Command 对象解决的正是这类“命令定义”问题，它把CommandText、CommandType、Parameters和ActiveConnection收在一起，执行时再决定返回记录集还是影响行数。

我一般把 Command 用在三个场景：需要参数化查询的列表页和详情页；需要调用存储过程并读取输出参数、返回值的业务动作；需要在事务里复用同一条命令模板的批量操作。反过来，如果只是一次性执行一条固定 SQL、不关心参数和复用，直接Connection::Execute更省事，但这类代码一旦多起来，后面排查 SQL 注入和类型转换问题会很痛苦。_CommandPtr是#import生成的智能指针包装，不是手写类，它的价值在于引用计数和_com_error异常路径，而不是替代数据库设计。

2.2 #import 导入 msado15.dll 与 _CommandPtr 的生成规则

VC++ 里用 ADO，常见做法是先导入 ADO 的类型库。#import会生成.tlh和.tli两个中间文件，里面就有_ConnectionPtr、_CommandPtr、_RecordsetPtr、_ParameterPtr这些智能指针。no_namespace让这些类型直接落在全局命名空间，少写ADODB::；rename("EOF", "adoEOF")和rename("BOF", "adoBOF")是为了避开 MFC 或其它头文件里的EOF宏冲突。路径按机器上的实际位置调整，不要硬编码到某台机器的私有目录。

#import "C:\Program Files\Common Files\System\ado\msado15.dll" \ no_namespace rename("EOF", "adoEOF") rename("BOF", "adoBOF") // _CommandPtr 由 #import 生成，CreateInstance 时才真正创建 COM 对象 _CommandPtr pCmd; pCmd.CreateInstance(__uuidof(Command));

逻辑说明：第一行把 ADO 类型库导入当前编译单元，生成智能指针和枚举常量；CreateInstance(__uuidof(Command))创建 Command 对象实例，失败会抛_com_error。参数说明：no_namespace影响类型名写法；rename只改生成代码里的枚举名，不改数据库里的字段名。注意#import路径里的空格和反斜杠在 C++ 字符串里要按编译器规则处理，常见写法是用双反斜杠或把路径放进项目附加包含目录。另一个容易忽略的点是CoInitialize或CoInitializeEx必须在创建任何 ADO 对象之前调用，MFC 项目里常用AfxOleInit()，控制台项目里用CoInitializeEx(NULL, COINIT_APARTMENTTHREADED)。

2.3 最小可编译闭环：CoInitialize、Connection、Command、Recordset

下面这段代码把“连上数据库、用 Command 执行一条查询、遍历 Recordset、按顺序释放”放在一个main里。连接字符串里的库名、用户名、密码都是示例值，实际替换成自己的测试库。CommandType用adCmdText，表示CommandText是一条 SQL 文本；Execute的第一个参数传NULL，表示不关心影响行数，第二个参数传NULL，表示参数已经通过Parameters集合绑定。

#include <windows.h> #include <comdef.h> #include <iostream> #import "C:\Program Files\Common Files\System\ado\msado15.dll" \ no_namespace rename("EOF", "adoEOF") rename("BOF", "adoBOF") int main() { HRESULT hr = CoInitializeEx(NULL, COINIT_APARTMENTTHREADED); if (FAILED(hr)) { std::cerr << "CoInitializeEx failed" << std::endl; return -1; } _ConnectionPtr pConn; _CommandPtr pCmd; _RecordsetPtr pRs; try { pConn.CreateInstance(__uuidof(Connection)); pConn->ConnectionString = _bstr_t( L"Provider=SQLOLEDB;Data Source=127.0.0.1;Initial Catalog=DemoDB;" L"User ID=dbuser;Password=P@ssw0rd;"); pConn->ConnectionTimeout = 5; pConn->Open(_bstr_t(L""), _bstr_t(L""), _bstr_t(L""), adConnectUnspecified); pCmd.CreateInstance(__uuidof(Command)); pCmd->ActiveConnection = pConn; pCmd->CommandType = adCmdText; pCmd->CommandText = _bstr_t( L"SELECT TOP 5 UserId, UserName FROM dbo.Users ORDER BY UserId"); pRs = pCmd->Execute(NULL, NULL, adCmdText); while (!pRs->adoEOF) { _variant_t vId = pRs->Fields->Item[_variant_t((long)0)]->Value; _variant_t vName = pRs->Fields->Item[_variant_t((long)1)]->Value; std::wcout << L"id=" << (long)vId << L", name=" << (wchar_t*)_bstr_t(vName) << std::endl; pRs->MoveNext(); } } catch (_com_error& e) { std::cerr << "HRESULT=0x" << std::hex << e.Error() << std::endl; std::cerr << "Message=" << (char*)e.ErrorMessage() << std::endl; if (e.Description().length() > 0) std::cerr << "Description=" << (char*)e.Description() << std::endl; } if (pRs != NULL && pRs->State != adStateClosed) pRs->Close(); pRs = NULL; if (pCmd != NULL) pCmd->ActiveConnection = NULL; pCmd = NULL; if (pConn != NULL && pConn->State != adStateClosed) pConn->Close(); pConn = NULL; CoUninitialize(); return 0; }

逻辑说明：ConnectionString里Provider指定 OLE DB 提供程序，Data Source是地址，Initial Catalog是库名；ConnectionTimeout单位是秒，设短一点能让连接失败更快暴露。Open的四个参数在已经设置ConnectionString时可以传空字符串，adConnectUnspecified表示同步打开。Command 的ActiveConnection指向已打开的 Connection，这样事务和连接复用都在这条连接上。Execute返回_RecordsetPtr，遍历时用adoEOF判断结束，字段取值用_variant_t接住再转换。释放顺序是 Recordset、Command、Connection，原因在下一节展开。

注意：连接字符串里的密码不要写进版本库。测试代码可以用环境变量或本地配置文件，提交前把Password=后面的内容替换掉。

2.4 生命周期与释放顺序：为什么先关 Recordset 再断 Connection

ADO 对象之间是引用关系，Command 持有 Connection 的引用，Recordset 又持有 Command 和 Connection 的引用。如果先pConn->Close()，再让 Recordset 或 Command 析构，常见现象是“对象关闭时不允许操作”或者连接池里留下半开连接。我的习惯是先把 Recordset 关掉并置空，再把 Command 的ActiveConnection断开，最后关 Connection。这个顺序不玄学，就是让引用一层层退掉。

另一个边界是 Command 的ActiveConnection可以直接赋连接字符串，让 Command 执行时自己打开连接。这样写起来短，但事务、连接复用和错误定位都会变麻烦：每次执行可能新建连接，事务也无法和外部 Connection 对齐。数据访问层里我一般坚持用已打开的 Connection，把连接生命周期交给上层，Command 只负责命令。多线程场景更要这样，ADO 对象不是线程安全的，跨线程共用一个_CommandPtr是典型的翻车点，后面避坑章节会展开。

3. 参数化查询落地：CreateParameter 的五个参数与 Execute 的四种返回

3.1 为什么 Command 要用 ? 占位符而不是拼接字符串

VC++Ado 里最常见的错误写法是把用户输入拼进 SQL：L"SELECT * FROM Users WHERE Name='" + name + L"'"。这种写法遇到单引号、日期格式、Unicode 字符就会出问题，更不用说注入风险。Command 的参数化查询用?占位符，参数值通过Parameters集合传入，由 OLE DB 提供程序负责转义和类型转换。SQL 文本里的?按出现顺序绑定，不是按名字绑定；存储过程才常用@Name这种命名参数。把这点分清，后面参数顺序错乱的问题会少很多。

参数化还有一个实际好处：同一条 SQL 模板可以反复执行，数据库更容易复用执行计划。批量插入、分页查询、按状态筛选列表这类场景，把 Command 对象建一次、参数值改一改再执行，比每次拼字符串更稳。需要注意的是，不是所有提供程序都支持命名参数，SQL 文本里写@Name再指望按名匹配，在部分驱动上会直接报“参数不足”。所以文本查询统一用?，存储过程统一用adCmdStoredProc加Refresh或手动 Append，这是比较省心的分界。

3.2 CreateParameter 的五个入参：Name、Type、Direction、Size、Value

CreateParameter返回一个_ParameterPtr，要把它Append到Parameters集合才会生效。五个入参里，Name对 SQL 文本参数没有匹配作用，但调试时能看到名字；Type决定数据库怎么理解这个值；Direction决定是输入、输出还是返回值；Size对变长类型很关键；Value是实际值。下面这张表是我常用的对照，具体类型仍要以目标库的列定义为准。

逻辑说明：adInteger对应 4 字节整数，Size传sizeof(int)只是习惯写法；adVarWChar对应宽字符变长字符串，Size不要一律写 8000，按列定义给 64、128、256 更稳；adDouble对应浮点，金额场景如果列是money或decimal，可以用adCurrency或adDecimal，但_variant_t的构造要匹配类型，否则会出现隐式转换。Direction在输入参数上写adParamInput，输出参数写adParamOutput，返回值写adParamReturnValue。参数追加顺序必须和 SQL 里?的顺序一致，这点没有捷径。

3.3 SELECT 查询：绑定参数并取回 _RecordsetPtr

下面这段代码查“年龄大于某个值、城市等于某个值”的用户列表。SQL 文本里有两个?，所以 Append 两次，顺序是年龄、城市。城市值用CityA这种示例值，实际替换成业务字段。Execute(NULL, NULL, adCmdText)返回_RecordsetPtr，如果查询没有结果，Recordset 仍然是打开状态，只是adoEOF为真。

_CommandPtr pCmd; pCmd.CreateInstance(__uuidof(Command)); pCmd->ActiveConnection = pConn; pCmd->CommandType = adCmdText; pCmd->CommandText = _bstr_t( L"SELECT UserId, UserName, Age FROM dbo.Users WHERE Age > ? AND City = ?"); // 第一个 ? 对应 Age，第二个 ? 对应 City，Append 顺序不能反 pCmd->Parameters->Append(pCmd->CreateParameter( _bstr_t(L"@Age"), adInteger, adParamInput, sizeof(int), _variant_t(18))); pCmd->Parameters->Append(pCmd->CreateParameter( _bstr_t(L"@City"), adVarWChar, adParamInput, 64, _variant_t(L"CityA"))); _RecordsetPtr pRs = pCmd->Execute(NULL, NULL, adCmdText); while (!pRs->adoEOF) { long userId = (long)pRs->Fields->Item[_variant_t((long)0)]->Value; _bstr_t userName = pRs->Fields->Item[_variant_t((long)1)]->Value; long age = (long)pRs->Fields->Item[_variant_t((long)2)]->Value; std::wcout << userId << L"," << (wchar_t*)userName << L"," << age << std::endl; pRs->MoveNext(); } pRs->Close(); pRs = NULL;

逻辑说明：CommandText里的?是占位符，不是字符串里的问号；Parameters->Append把创建好的参数加入集合，未 Append 的参数不会参与绑定。Fields->Item用序号取值，序号从 0 开始，和 SELECT 列表顺序一致。_bstr_t userName = ...会做一次转换，宽字符输出时再转wchar_t*。参数说明：adVarWChar的Size=64表示最多 64 个宽字符，城市名一般够用；如果列是nvarchar(200)，这里给 200 更稳，给太小可能截断或报错。

3.4 非查询与影响行数：Execute 的 RecordsAffected 怎么读

INSERT、UPDATE、DELETE 用同一个 Command 对象执行时，返回值可能不是 Recordset，而是影响行数。Execute的第一个参数传_variant_t的地址，执行后从这个 variant 里读行数。注意不要对非查询的返回值直接解引用 Recordset，很多提供程序在这种情况下返回 NULL。行数在某些语句里可能是 -1，比如带触发器或某些批处理，这时不要拿它做严格业务判断。

_CommandPtr pCmd; pCmd.CreateInstance(__uuidof(Command)); pCmd->ActiveConnection = pConn; pCmd->CommandType = adCmdText; pCmd->CommandText = _bstr_t( L"UPDATE dbo.Users SET Age = ? WHERE UserId = ?"); pCmd->Parameters->Append(pCmd->CreateParameter( _bstr_t(L"@Age"), adInteger, adParamInput, sizeof(int), _variant_t(30))); pCmd->Parameters->Append(pCmd->CreateParameter( _bstr_t(L"@UserId"), adInteger, adParamInput, sizeof(int), _variant_t(1001))); _variant_t vtRows; _RecordsetPtr pRs = pCmd->Execute(&vtRows, NULL, adCmdText); long affected = (vtRows.vt == VT_I4) ? vtRows.lVal : -1; std::wcout << L"affected=" << affected << std::endl; if (pRs != NULL && pRs->State != adStateClosed) pRs->Close(); pRs = NULL;

逻辑说明：&vtRows接收影响行数，pRs可能为 NULL；判断vtRows.vt == VT_I4再取lVal，不要假定一定是 4 字节整数。参数说明：adInteger的Value用_variant_t(30)构造，类型是VT_I4；如果参数值来自界面文本，先做_wtoi或更严格的校验，不要把字符串直接塞进整数参数。影响行数为 0 不一定是错误，可能是条件不匹配；为 -1 时看提供程序文档或改用SELECT @@ROWCOUNT验证。

3.5 参数类型与 NULL 值：_variant_t 的 VT_NULL 与 adVarWChar 长度

NULL 值不能用空字符串代替。字符串参数的 NULL 要构造VT_NULL的_variant_t，再赋给参数值。日期参数用adDBTimeStamp或adDate，值用_variant_t的VT_DATE；金额参数如果列是decimal，用adDecimal并设置Precision和NumericScale，否则可能出现精度截断。adVarWChar的长度按字符数设置，nvarchar(max)用adLongVarWChar，不要拿adVarWChar硬塞超长文本。

_CommandPtr pCmd; pCmd.CreateInstance(__uuidof(Command)); pCmd->ActiveConnection = pConn; pCmd->CommandType = adCmdText; pCmd->CommandText = _bstr_t( L"INSERT INTO dbo.Users(UserName, City, Remark) VALUES(?, ?, ?)"); pCmd->Parameters->Append(pCmd->CreateParameter( _bstr_t(L"@UserName"), adVarWChar, adParamInput, 64, _variant_t(L"UserA"))); pCmd->Parameters->Append(pCmd->CreateParameter( _bstr_t(L"@City"), adVarWChar, adParamInput, 64, _variant_t(L"CityA"))); _variant_t vtNull; vtNull.vt = VT_NULL; pCmd->Parameters->Append(pCmd->CreateParameter( _bstr_t(L"@Remark"), adLongVarWChar, adParamInput, 4000, vtNull)); _variant_t vtRows; pCmd->Execute(&vtRows, NULL, adCmdText);

逻辑说明：vtNull.vt = VT_NULL表示数据库里的 NULL，不是空串；`adLongVar

本文还有配套的精品资源，点击获取