简介这份资源面向具备一定VC基础、希望掌握数据库访问技术的开发者聚焦ADO中Command对象的实际运用通过可编译的示例工程演示如何执行SQL语句、调用存储过程以及进行带参数的查询。压缩包共11个文件约8KB以cpp与h源码文件为主辅以vcxproj、sln等Visual Studio工程配置文件和一份说明txt构成一个结构完整、可直接打开编译的TestAdo项目。工程中围绕_CommandPtr的创建与初始化、ActiveConnection与CommandText等属性设置、Parameter参数对象的追加、Execute执行与结果集获取等环节给出代码示例并包含AdoEvent相关的事件处理内容便于读者对照理解命令对象在真实项目中的组织方式。目前已有527人学习下载适合作为VC环境下ADO数据库编程的入门练手与查阅参考帮助读者把零散概念落到可运行的代码上。1. 从一次“连接明明通了、查询却卡死”说起上周帮一个做设备采集的同行看代码场景很典型VC 里用 ADO 连上了数据库_ConnectionPtr打开成功日志也打了“connected”可一执行带参数的查询就卡住界面直接假死。翻到最后发现他全程只用了_ConnectionPtr把 SQL 拼成字符串往Execute里塞参数靠sprintf拼遇到单引号和日期格式就翻车。这类问题在 ADO 里几乎都指向同一个角色——Command对象没被用起来。这份 Ado 实例资源核心就是把_CommandPtr这个对象讲透它怎么创建、怎么绑定参数、怎么执行返回结果集、怎么和_ConnectionPtr、_RecordsetPtr配合。适合两类人一是刚在 VC 里接数据库、还在拼 SQL 字符串的新手二是用了几年 ADO 但一直绕开 Command、想搞清楚参数化查询和存储过程调用的熟手。下面按“它是什么 → 怎么落地 → 坑在哪 → 怎么验证”的顺序拆代码都能直接抄进工程改。2. Command 对象到底解决什么问题三种执行方式与参数化查询的底层逻辑2.1 为什么不能只靠 Connection 和 RecordsetADO 的三个核心对象分工很清楚_ConnectionPtr管连接和事务边界_RecordsetPtr管结果集的游标和遍历_CommandPtr管“要执行的那条命令”本身。很多人图省事用Connection-Execute(select ...)直接跑短 SQL 没问题一旦涉及参数就露馅。拼字符串的写法长这样CString sql; sql.Format(_T(select * from t_device where dev_no%s and sample_time%s), devNo, startTime); m_pConn-Execute(_bstr_t(sql), NULL, adCmdText);问题有三个。第一devNo里只要有一个单引号SQL 直接语法错误这就是最朴素的注入面。第二日期、浮点数在不同数据库驱动下的字面量格式不一样2024-01-01 00:00:00在有的驱动里认有的要to_date。第三同一条 SQL 反复执行时数据库端每次都要重新解析执行计划批量场景下性能差距明显。_CommandPtr的价值就在这命令文本和执行参数分离参数以Parameters集合的形式传给驱动由驱动负责转义和类型映射。同一条命令可以改参数反复执行执行计划能复用。这不是玄学是 ADO 设计时就定好的路径。2.2 Command 的三种执行入口_CommandPtr提供三个方法对应三种返回形态选错就是白折腾方法返回适用场景注意点Execute_RecordsetPtr有结果集的查询需要传rs出参失败抛_com_errorExecute不取出参无INSERT/UPDATE/DELETE影响行数要从连接或命令上另取Parameters-Refresh()无存储过程/参数化命令必须在设CommandText之后调用新手最容易犯的错是拿Execute去跑 UPDATE 还指望拿到影响行数。Execute对非查询语句返回的 Recordset 是关闭状态行数拿不到。要拿影响行数常见做法是执行后读Connection上的RecordsAffected或者干脆用adExecuteNoRecords选项减少往返。2.3 参数化查询的绑定顺序Parameters集合是按位置绑定的不是按名字。也就是说你Append的顺序必须和 SQL 里?出现的顺序严格一致。这一点在 SQL Server 的 OLE DB 驱动下尤其明显——你给参数起了devNo这样的名字驱动也不认只认位置。_CommandPtr pCmd; pCmd.CreateInstance(__uuidof(Command)); pCmd-ActiveConnection m_pConn; pCmd-CommandText _bstr_t( Lselect dev_no, sample_time, value from t_sample Lwhere dev_no ? and sample_time between ? and ?); pCmd-CommandType adCmdText; // 顺序必须与 ? 一致dev_no、起始时间、结束时间 pCmd-Parameters-Append(pCmd-CreateParameter( LdevNo, adVarWChar, adParamInput, 32, _variant_t(devNo))); pCmd-Parameters-Append(pCmd-CreateParameter( Lt1, adDBTimeStamp, adParamInput, 0, _variant_t(startTime))); pCmd-Parameters-Append(pCmd-CreateParameter( Lt2, adDBTimeStamp, adParamInput, 0, _variant_t(endTime))); _RecordsetPtr pRs pCmd-Execute(NULL, NULL, adCmdText);CreateParameter的五个参数依次是名字、类型、方向、大小、值。名字只是给人看的类型和大小才是驱动真正用的。adVarWChar对应宽字符adDBTimeStamp对应DATE/DATETIME类型给错驱动会做隐式转换转换失败就抛_com_error错误码往往只告诉你“类型不匹配”不告诉你是哪个参数这是后面避坑章要展开的点。3. 在 VC 工程里把 Command 跑起来从导入类型库到封装执行3.1 导入 ADO 类型库的两种方式VC 用 ADO 前必须先让编译器认识_CommandPtr这些智能指针。常见做法是#import// stdafx.h 或 pch.h 里加 #import C:\Program Files\Common Files\System\ado\msado15.dll \ no_namespace rename(EOF, EndOfFile) rename(BOF, BeginOfFile)no_namespace避免所有符号被塞进一个命名空间rename是因为EOF、BOF和标准库/其他头文件冲突这是血泪经验不 rename 编译期就报重定义。导入后_CommandPtr、_ConnectionPtr、_RecordsetPtr都是_com_ptr_t包装的智能指针CreateInstance(__uuidof(Command))就能实例化。另一种是走#import的.tlh/.tli生成文件工程里能看到msado15.tlh调试时看它里面的接口声明比查文档快。注意#import要放在windows.h之后否则COM相关宏没定义。3.2 COM 初始化与连接建立ADO 底层是 COM线程里必须先CoInitialize否则CreateInstance返回E_FAIL错误信息还特别含糊。// 工作线程入口 HRESULT hr CoInitializeEx(NULL, COINIT_MULTITHREADED); if (FAILED(hr)) return; try { m_pConn.CreateInstance(__uuidof(Connection)); // 连接串按实际驱动改这里以 SQL Server 为例 m_pConn-Open( LProviderSQLOLEDB;Data Source127.0.0.1; LInitial Catalogtestdb;User IDsa;Password***;, L, L, adConnectUnspecified); // 连接级超时防止网络抖动时无限等待 m_pConn-CommandTimeout 30; m_pConn-ConnectionTimeout 10; } catch (_com_error e) { // e.Description() 才是人话e.ErrorMessage() 只是错误码文本 OutputDebugString(e.Description()); }adConnectUnspecified表示同步打开异步打开要配事件一般采集类程序用同步就够。CommandTimeout是命令执行超时ConnectionTimeout是建连超时两个都要设只设一个在弱网下照样卡死。_com_error的Description()来自驱动比ErrorMessage()有用得多日志里一定要打它。3.3 封装一个可复用的 Command 执行函数工程里不建议每处都手写CreateParameter封装一层把“命令文本 参数数组”作为输入返回 Recordset 或影响行数。struct SqlParam { CString name; DataTypeEnum type; // adVarWChar / adInteger / adDBTimeStamp ... long size; _variant_t value; }; _RecordsetPtr ExecCommand(_ConnectionPtr conn, const CString sql, const std::vectorSqlParam params, long* affected nullptr) { _CommandPtr cmd; cmd.CreateInstance(__uuidof(Command)); cmd-ActiveConnection conn; cmd-CommandText _bstr_t(sql); cmd-CommandType adCmdText; cmd-CommandTimeout 30; for (const auto p : params) { cmd-Parameters-Append(cmd-CreateParameter( _bstr_t(p.name), p.type, adParamInput, p.size, p.value)); } if (affected) { // 非查询语句走无结果集路径减少往返 cmd-Execute(NULL, NULL, adExecuteNoRecords); *affected conn-RecordsAffected; return nullptr; } return cmd-Execute(NULL, NULL, adCmdText); }调用侧就干净了std::vectorSqlParam ps; ps.push_back({LdevNo, adVarWChar, 32, _variant_t(devNo)}); ps.push_back({Lt1, adDBTimeStamp, 0, _variant_t(startTime)}); ps.push_back({Lt2, adDBTimeStamp, 0, _variant_t(endTime)}); _RecordsetPtr rs ExecCommand(m_pConn, Lselect dev_no, value from t_sample where dev_no? and sample_time between ? and ?, ps); while (!rs-EndOfFile) { CString dev (LPCTSTR)(_bstr_t)rs-Fields-Item[Ldev_no]-Value; double v rs-Fields-Item[Lvalue]-Value; rs-MoveNext(); } rs-Close();adExecuteNoRecords是关键参数告诉驱动这条命令不返回结果集省掉一次结果集对象的创建。RecordsAffected在连接对象上读注意它是“最近一次操作”的影响行数多线程共用连接时会串所以连接不要跨线程共享这是后面避坑章的重点。3.4 存储过程调用与输出参数Command 对存储过程的支持比拼 SQL 强得多因为可以声明输出参数。_CommandPtr cmd; cmd.CreateInstance(__uuidof(Command)); cmd-ActiveConnection m_pConn; cmd-CommandText _bstr_t(Lproc_calc_daily); cmd-CommandType adCmdStoredProc; // 先 Refresh 让驱动把参数定义拉回来再改值 cmd-Parameters-Refresh(); cmd-Parameters-Item[Ldev_no]-Value _variant_t(devNo); cmd-Parameters-Item[Lday]-Value _variant_t(day); cmd-Execute(NULL, NULL, adExecuteNoRecords); // 输出参数在 Refresh 后已存在方向为 adParamOutput _variant_t total cmd-Parameters-Item[Ltotal]-Value;Refresh()必须在CommandText和CommandType都设好之后调用否则拉不到参数定义。存储过程参数名带Item用名字索引比用序号稳因为不同驱动返回的参数顺序不一定和定义一致。输出参数的方向由驱动在 Refresh 时填好不要手动改成adParamInputOutput改了反而可能报错。4. Command 用起来最容易翻车的几个点现象、原因与解决4.1 参数顺序错位查询结果莫名其妙现象SQL 里两个?参数也 Append 了两个但查出来的数据总是对不上或者日期条件永远不命中。原因Parameters按位置绑定Append 顺序和?顺序不一致。更隐蔽的是有人先Append了参数再改CommandText驱动内部参数集合和文本对不上执行时静默错位。解决把“SQL 文本”和“参数数组”放在同一个结构里维护Append 时按数组顺序走不要中途改CommandText。改文本就重建 Command 对象别复用。4.2 类型给错报“类型不匹配”但不说是哪个参数现象Execute抛_com_errorDescription()只写“多步操作产生错误”或“类型不匹配”定位不到具体参数。原因CreateParameter的type和实际_variant_t的类型不一致驱动做隐式转换失败。典型是字符串给了adVarChar却传了宽字符或者整数给了adVarWChar。解决参数类型和_variant_t的构造类型严格对应。字符串统一adVarWChar_variant_t(L...)整数adInteger_variant_t((long)n)时间adDBTimeStamp_variant_t(COleDateTime)。出错时把每个参数的Name、Type、Value打日志比看错误码快。4.3 多线程共用 ConnectionRecordsAffected 串值现象两个线程同时执行 UPDATEA 线程读到的RecordsAffected是 B 线程的结果统计全乱。原因RecordsAffected挂在Connection上是连接级状态不是命令级。ADO 的 Connection 本身不是线程安全的。解决每个线程独立CoInitialize 独立 Connection或者用连接池但保证同一时刻一个连接只被一个线程用。Command 对象也不要跨线程复用_com_ptr_t的引用计数不解决并发访问问题。4.4 忘记 Close 和 Release句柄泄漏现象程序跑几小时后数据库连接数打满新连接被拒。原因_RecordsetPtr用完没Close()_CommandPtr没置空智能指针的析构依赖作用域长生命周期对象里容易漏。解决Recordset 用完立即Close()Command 在函数内用局部变量出作用域自动释放。连接对象在析构里显式Close()再置NULL。用 RAII 包一层也行但别指望_com_ptr_t帮你管连接状态。4.5 超时没设弱网下界面假死现象数据库网络抖动时Execute卡住几十秒UI 线程无响应。原因CommandTimeout默认值因驱动而异有的接近无限。UI 线程直接跑 ADO 是原罪。解决CommandTimeout设 1030 秒ConnectionTimeout设 510 秒。数据库操作放工作线程UI 线程只收结果。超时抛_com_error后要判断错误码别把超时当业务错误处理。5. 验证 Command 是否真的生效三个可落地的检查手段5.1 用 SQL Profiler 类工具看实际下发的语句参数化查询生效的标志是数据库端收到的是带参数占位符的语句而不是拼好的字面量。用数据库自带的跟踪工具抓一次执行如果看到sp_executesql带P1这类参数声明说明走的是参数化路径如果看到完整拼好的 SQL 文本说明你还在拼字符串。这一步能直接证伪“我用了 Command 但其实是拼的”。5.2 构造边界数据做回归准备一组专门恶心人的参数带单引号的字符串OBrien、带%的模糊查询值、NULL、空字符串、时间边界23:59:59。用同一套ExecCommand跑一遍全部通过才算参数绑定正确。拼字符串的写法在OBrien这一条上必挂这是最快的分水岭测试。5.3 批量执行看执行计划复用同一条参数化命令连续执行 1000 次改参数不改文本观察数据库端的执行计划缓存命中情况。如果每次都是硬解析说明 Command 对象被反复重建或者文本在变。正确做法是 Command 对象复用、只改Parameters-Item[i]-Value这样执行计划能稳定复用。我一般会在封装层加一个计数器统计“命令重建次数 / 执行次数”比值接近 0 才算合格。从那以后我每次接 ADO 相关代码第一件事就是搜工程里有没有Format(_T(select这种拼接有就先改成 Command 参数化再谈别的优化。参数顺序、类型对应、超时设置这三样我强制在封装层里走一遍检查不给自己留后悔药。希望帮到你。本文还有配套的精品资源点击获取
简介这份资源面向具备一定VC基础、希望掌握数据库访问技术的开发者聚焦ADO中Command对象的实际运用通过可编译的示例工程演示如何执行SQL语句、调用存储过程以及进行带参数的查询。压缩包共11个文件约8KB以cpp与h源码文件为主辅以vcxproj、sln等Visual Studio工程配置文件和一份说明txt构成一个结构完整、可直接打开编译的TestAdo项目。工程中围绕_CommandPtr的创建与初始化、ActiveConnection与CommandText等属性设置、Parameter参数对象的追加、Execute执行与结果集获取等环节给出代码示例并包含AdoEvent相关的事件处理内容便于读者对照理解命令对象在真实项目中的组织方式。目前已有527人学习下载适合作为VC环境下ADO数据库编程的入门练手与查阅参考帮助读者把零散概念落到可运行的代码上。1. 从一次“连接明明通了、查询却卡死”说起上周帮一个做设备采集的同行看代码场景很典型VC 里用 ADO 连上了数据库_ConnectionPtr打开成功日志也打了“connected”可一执行带参数的查询就卡住界面直接假死。翻到最后发现他全程只用了_ConnectionPtr把 SQL 拼成字符串往Execute里塞参数靠sprintf拼遇到单引号和日期格式就翻车。这类问题在 ADO 里几乎都指向同一个角色——Command对象没被用起来。这份 Ado 实例资源核心就是把_CommandPtr这个对象讲透它怎么创建、怎么绑定参数、怎么执行返回结果集、怎么和_ConnectionPtr、_RecordsetPtr配合。适合两类人一是刚在 VC 里接数据库、还在拼 SQL 字符串的新手二是用了几年 ADO 但一直绕开 Command、想搞清楚参数化查询和存储过程调用的熟手。下面按“它是什么 → 怎么落地 → 坑在哪 → 怎么验证”的顺序拆代码都能直接抄进工程改。2. Command 对象到底解决什么问题三种执行方式与参数化查询的底层逻辑2.1 为什么不能只靠 Connection 和 RecordsetADO 的三个核心对象分工很清楚_ConnectionPtr管连接和事务边界_RecordsetPtr管结果集的游标和遍历_CommandPtr管“要执行的那条命令”本身。很多人图省事用Connection-Execute(select ...)直接跑短 SQL 没问题一旦涉及参数就露馅。拼字符串的写法长这样CString sql; sql.Format(_T(select * from t_device where dev_no%s and sample_time%s), devNo, startTime); m_pConn-Execute(_bstr_t(sql), NULL, adCmdText);问题有三个。第一devNo里只要有一个单引号SQL 直接语法错误这就是最朴素的注入面。第二日期、浮点数在不同数据库驱动下的字面量格式不一样2024-01-01 00:00:00在有的驱动里认有的要to_date。第三同一条 SQL 反复执行时数据库端每次都要重新解析执行计划批量场景下性能差距明显。_CommandPtr的价值就在这命令文本和执行参数分离参数以Parameters集合的形式传给驱动由驱动负责转义和类型映射。同一条命令可以改参数反复执行执行计划能复用。这不是玄学是 ADO 设计时就定好的路径。2.2 Command 的三种执行入口_CommandPtr提供三个方法对应三种返回形态选错就是白折腾方法返回适用场景注意点Execute_RecordsetPtr有结果集的查询需要传rs出参失败抛_com_errorExecute不取出参无INSERT/UPDATE/DELETE影响行数要从连接或命令上另取Parameters-Refresh()无存储过程/参数化命令必须在设CommandText之后调用新手最容易犯的错是拿Execute去跑 UPDATE 还指望拿到影响行数。Execute对非查询语句返回的 Recordset 是关闭状态行数拿不到。要拿影响行数常见做法是执行后读Connection上的RecordsAffected或者干脆用adExecuteNoRecords选项减少往返。2.3 参数化查询的绑定顺序Parameters集合是按位置绑定的不是按名字。也就是说你Append的顺序必须和 SQL 里?出现的顺序严格一致。这一点在 SQL Server 的 OLE DB 驱动下尤其明显——你给参数起了devNo这样的名字驱动也不认只认位置。_CommandPtr pCmd; pCmd.CreateInstance(__uuidof(Command)); pCmd-ActiveConnection m_pConn; pCmd-CommandText _bstr_t( Lselect dev_no, sample_time, value from t_sample Lwhere dev_no ? and sample_time between ? and ?); pCmd-CommandType adCmdText; // 顺序必须与 ? 一致dev_no、起始时间、结束时间 pCmd-Parameters-Append(pCmd-CreateParameter( LdevNo, adVarWChar, adParamInput, 32, _variant_t(devNo))); pCmd-Parameters-Append(pCmd-CreateParameter( Lt1, adDBTimeStamp, adParamInput, 0, _variant_t(startTime))); pCmd-Parameters-Append(pCmd-CreateParameter( Lt2, adDBTimeStamp, adParamInput, 0, _variant_t(endTime))); _RecordsetPtr pRs pCmd-Execute(NULL, NULL, adCmdText);CreateParameter的五个参数依次是名字、类型、方向、大小、值。名字只是给人看的类型和大小才是驱动真正用的。adVarWChar对应宽字符adDBTimeStamp对应DATE/DATETIME类型给错驱动会做隐式转换转换失败就抛_com_error错误码往往只告诉你“类型不匹配”不告诉你是哪个参数这是后面避坑章要展开的点。3. 在 VC 工程里把 Command 跑起来从导入类型库到封装执行3.1 导入 ADO 类型库的两种方式VC 用 ADO 前必须先让编译器认识_CommandPtr这些智能指针。常见做法是#import// stdafx.h 或 pch.h 里加 #import C:\Program Files\Common Files\System\ado\msado15.dll \ no_namespace rename(EOF, EndOfFile) rename(BOF, BeginOfFile)no_namespace避免所有符号被塞进一个命名空间rename是因为EOF、BOF和标准库/其他头文件冲突这是血泪经验不 rename 编译期就报重定义。导入后_CommandPtr、_ConnectionPtr、_RecordsetPtr都是_com_ptr_t包装的智能指针CreateInstance(__uuidof(Command))就能实例化。另一种是走#import的.tlh/.tli生成文件工程里能看到msado15.tlh调试时看它里面的接口声明比查文档快。注意#import要放在windows.h之后否则COM相关宏没定义。3.2 COM 初始化与连接建立ADO 底层是 COM线程里必须先CoInitialize否则CreateInstance返回E_FAIL错误信息还特别含糊。// 工作线程入口 HRESULT hr CoInitializeEx(NULL, COINIT_MULTITHREADED); if (FAILED(hr)) return; try { m_pConn.CreateInstance(__uuidof(Connection)); // 连接串按实际驱动改这里以 SQL Server 为例 m_pConn-Open( LProviderSQLOLEDB;Data Source127.0.0.1; LInitial Catalogtestdb;User IDsa;Password***;, L, L, adConnectUnspecified); // 连接级超时防止网络抖动时无限等待 m_pConn-CommandTimeout 30; m_pConn-ConnectionTimeout 10; } catch (_com_error e) { // e.Description() 才是人话e.ErrorMessage() 只是错误码文本 OutputDebugString(e.Description()); }adConnectUnspecified表示同步打开异步打开要配事件一般采集类程序用同步就够。CommandTimeout是命令执行超时ConnectionTimeout是建连超时两个都要设只设一个在弱网下照样卡死。_com_error的Description()来自驱动比ErrorMessage()有用得多日志里一定要打它。3.3 封装一个可复用的 Command 执行函数工程里不建议每处都手写CreateParameter封装一层把“命令文本 参数数组”作为输入返回 Recordset 或影响行数。struct SqlParam { CString name; DataTypeEnum type; // adVarWChar / adInteger / adDBTimeStamp ... long size; _variant_t value; }; _RecordsetPtr ExecCommand(_ConnectionPtr conn, const CString sql, const std::vectorSqlParam params, long* affected nullptr) { _CommandPtr cmd; cmd.CreateInstance(__uuidof(Command)); cmd-ActiveConnection conn; cmd-CommandText _bstr_t(sql); cmd-CommandType adCmdText; cmd-CommandTimeout 30; for (const auto p : params) { cmd-Parameters-Append(cmd-CreateParameter( _bstr_t(p.name), p.type, adParamInput, p.size, p.value)); } if (affected) { // 非查询语句走无结果集路径减少往返 cmd-Execute(NULL, NULL, adExecuteNoRecords); *affected conn-RecordsAffected; return nullptr; } return cmd-Execute(NULL, NULL, adCmdText); }调用侧就干净了std::vectorSqlParam ps; ps.push_back({LdevNo, adVarWChar, 32, _variant_t(devNo)}); ps.push_back({Lt1, adDBTimeStamp, 0, _variant_t(startTime)}); ps.push_back({Lt2, adDBTimeStamp, 0, _variant_t(endTime)}); _RecordsetPtr rs ExecCommand(m_pConn, Lselect dev_no, value from t_sample where dev_no? and sample_time between ? and ?, ps); while (!rs-EndOfFile) { CString dev (LPCTSTR)(_bstr_t)rs-Fields-Item[Ldev_no]-Value; double v rs-Fields-Item[Lvalue]-Value; rs-MoveNext(); } rs-Close();adExecuteNoRecords是关键参数告诉驱动这条命令不返回结果集省掉一次结果集对象的创建。RecordsAffected在连接对象上读注意它是“最近一次操作”的影响行数多线程共用连接时会串所以连接不要跨线程共享这是后面避坑章的重点。3.4 存储过程调用与输出参数Command 对存储过程的支持比拼 SQL 强得多因为可以声明输出参数。_CommandPtr cmd; cmd.CreateInstance(__uuidof(Command)); cmd-ActiveConnection m_pConn; cmd-CommandText _bstr_t(Lproc_calc_daily); cmd-CommandType adCmdStoredProc; // 先 Refresh 让驱动把参数定义拉回来再改值 cmd-Parameters-Refresh(); cmd-Parameters-Item[Ldev_no]-Value _variant_t(devNo); cmd-Parameters-Item[Lday]-Value _variant_t(day); cmd-Execute(NULL, NULL, adExecuteNoRecords); // 输出参数在 Refresh 后已存在方向为 adParamOutput _variant_t total cmd-Parameters-Item[Ltotal]-Value;Refresh()必须在CommandText和CommandType都设好之后调用否则拉不到参数定义。存储过程参数名带Item用名字索引比用序号稳因为不同驱动返回的参数顺序不一定和定义一致。输出参数的方向由驱动在 Refresh 时填好不要手动改成adParamInputOutput改了反而可能报错。4. Command 用起来最容易翻车的几个点现象、原因与解决4.1 参数顺序错位查询结果莫名其妙现象SQL 里两个?参数也 Append 了两个但查出来的数据总是对不上或者日期条件永远不命中。原因Parameters按位置绑定Append 顺序和?顺序不一致。更隐蔽的是有人先Append了参数再改CommandText驱动内部参数集合和文本对不上执行时静默错位。解决把“SQL 文本”和“参数数组”放在同一个结构里维护Append 时按数组顺序走不要中途改CommandText。改文本就重建 Command 对象别复用。4.2 类型给错报“类型不匹配”但不说是哪个参数现象Execute抛_com_errorDescription()只写“多步操作产生错误”或“类型不匹配”定位不到具体参数。原因CreateParameter的type和实际_variant_t的类型不一致驱动做隐式转换失败。典型是字符串给了adVarChar却传了宽字符或者整数给了adVarWChar。解决参数类型和_variant_t的构造类型严格对应。字符串统一adVarWChar_variant_t(L...)整数adInteger_variant_t((long)n)时间adDBTimeStamp_variant_t(COleDateTime)。出错时把每个参数的Name、Type、Value打日志比看错误码快。4.3 多线程共用 ConnectionRecordsAffected 串值现象两个线程同时执行 UPDATEA 线程读到的RecordsAffected是 B 线程的结果统计全乱。原因RecordsAffected挂在Connection上是连接级状态不是命令级。ADO 的 Connection 本身不是线程安全的。解决每个线程独立CoInitialize 独立 Connection或者用连接池但保证同一时刻一个连接只被一个线程用。Command 对象也不要跨线程复用_com_ptr_t的引用计数不解决并发访问问题。4.4 忘记 Close 和 Release句柄泄漏现象程序跑几小时后数据库连接数打满新连接被拒。原因_RecordsetPtr用完没Close()_CommandPtr没置空智能指针的析构依赖作用域长生命周期对象里容易漏。解决Recordset 用完立即Close()Command 在函数内用局部变量出作用域自动释放。连接对象在析构里显式Close()再置NULL。用 RAII 包一层也行但别指望_com_ptr_t帮你管连接状态。4.5 超时没设弱网下界面假死现象数据库网络抖动时Execute卡住几十秒UI 线程无响应。原因CommandTimeout默认值因驱动而异有的接近无限。UI 线程直接跑 ADO 是原罪。解决CommandTimeout设 1030 秒ConnectionTimeout设 510 秒。数据库操作放工作线程UI 线程只收结果。超时抛_com_error后要判断错误码别把超时当业务错误处理。5. 验证 Command 是否真的生效三个可落地的检查手段5.1 用 SQL Profiler 类工具看实际下发的语句参数化查询生效的标志是数据库端收到的是带参数占位符的语句而不是拼好的字面量。用数据库自带的跟踪工具抓一次执行如果看到sp_executesql带P1这类参数声明说明走的是参数化路径如果看到完整拼好的 SQL 文本说明你还在拼字符串。这一步能直接证伪“我用了 Command 但其实是拼的”。5.2 构造边界数据做回归准备一组专门恶心人的参数带单引号的字符串OBrien、带%的模糊查询值、NULL、空字符串、时间边界23:59:59。用同一套ExecCommand跑一遍全部通过才算参数绑定正确。拼字符串的写法在OBrien这一条上必挂这是最快的分水岭测试。5.3 批量执行看执行计划复用同一条参数化命令连续执行 1000 次改参数不改文本观察数据库端的执行计划缓存命中情况。如果每次都是硬解析说明 Command 对象被反复重建或者文本在变。正确做法是 Command 对象复用、只改Parameters-Item[i]-Value这样执行计划能稳定复用。我一般会在封装层加一个计数器统计“命令重建次数 / 执行次数”比值接近 0 才算合格。从那以后我每次接 ADO 相关代码第一件事就是搜工程里有没有Format(_T(select这种拼接有就先改成 Command 参数化再谈别的优化。参数顺序、类型对应、超时设置这三样我强制在封装层里走一遍检查不给自己留后悔药。希望帮到你。本文还有配套的精品资源点击获取
