简介这是一份基于Visual C与ODBC接口操作Access MDB数据库的完整通讯录项目源码适合初学者及Windows桌面数据库应用开发者。项目通过经典通讯录场景演示了在VC环境中配置ODBC数据源、使用MFC的CDatabase与CRecordset类完成记录查询、添加、修改与删除并包含登录密码验证、修改密码、联系人信息维护等实用模块覆盖数据库编程核心环节。压缩包共32个文件主要由12个头文件.h与11个C源文件.cpp构成附带addresslist.mdb数据库文件以及工程配置、界面资源与说明文档整体仅42KB结构紧凑便于阅读和二次开发源码中主对话框、添加信息对话框、修改密码对话框等模块划分清晰注释简明。目前已有381人学习下载。通过该项目读者可掌握ODBC连接字符串配置、SQL语句调用方式以及常见数据库错误的调试思路同时可复用其中的代码封装为开发实际办公或管理类应用程序打下坚实基础。1. Visual C 源码操作 Access MDB一个通讯录工程的完整拆解很多 Windows 桌面数据库开发是从「Visual C 源码 ODBC Access MDB」这个组合开始的。这套 AddressList 通讯录就是典型代表VC 6.0 的 MFC 对话框工程数据存在 addresslist.mdb 里程序通过 ODBC 接口完成联系人的增删改查、模糊搜索、密码保护。对要交课程设计、或者要接手老桌面项目的人来说它把 CDatabase、CRecordset、ODBC 连接串这三样最核心的东西浓缩在一个能编译、能跑、能改的小工程里。没有数据库服务端不需要安装额外运行时MDB 文件拷到哪都能连这正是它到今天还有参考价值的原因。下面按「连接通道 → 记录集封装 → 避坑 → 改造」四条线拆解。2. ODBC 连接通道先搞懂 DSN 和无 DSN 两种接法拿到工程先别急着编译。这套 AddressList 的源码文件虽然多但按职责分就三类对话框界面MainDlg、AddInfoDlg、ModifyDlg、SearchDlg、ChangePswDlg、记录集封装PersonSet、程序入口与资源Address、AddressDlg、Resource.rc。先摸清楚文件分工后面排查问题时才知道去哪看。2.1 文件清单与模块分工工程里最容易让人懵的是十几个 .cpp 和 .h 堆在一起。我用下面这个表把主要文件的职责理一遍你拿到手可以先对照着过一眼。文件职责定位Address.cpp / AddressDlg.cpp程序入口与主对话框负责初始化和菜单路由MainDlg.cpp / MainDlg.h主界面联系人列表展示与功能按钮分发PersonSet.cpp / PersonSet.hCRecordset 派生类封装联系人表的读写AddInfoDlg.cpp / ModifyDlg.cpp添加与修改联系人的表单对话框SearchDlg.cpp按姓名关键字做模糊搜索PswdSet.cpp / ChangePswDlg.cpp登录密码校验与修改密码addresslist.mdbAccess 数据库文件存联系人数据Address.dsp / Address.dswVC 6.0 工程文件用 VC6 或兼容 IDE 打开这个表本身就是排查地图界面问题去对话框类里看数据问题去 PersonSet 和 .mdb 里看连接问题优先看打开数据库的那几行代码。我自己拿到陌生工程的习惯是先搜索CDatabase和Open(两个关键字把数据库连接的入口定位到再顺着数据流读代码。2.2 建 DSN最快让程序跑起来的方式在控制面板 → 管理工具 → ODBC 数据源32 位里添加一个用户 DSN驱动选 Microsoft Access Driver把路径指向 addresslist.mdb数据源名随便填比如 AddressListDSN。这是最省事的接入方式适合第一次跑这个工程。VC6 时代的代码里最常见的写法是直接靠 DSN 打开数据库CDatabase db; // DSN 方式第一个参数传数据源名称 db.Open(_T(AddressListDSN), FALSE, FALSE, _T());Open四个参数的含义值得记一下第一个是数据源名第二个 bExclusive 传 FALSE表示不独占打开 MDB。第三个 bReadOnly 也传 FALSE因为通讯录要写库。最后一个参数是连接串DSN 方式下传空字符串即可。这里最常翻车的点是把 bExclusive 传成 TRUE后面别的程序再碰同一个 MDB 文件就会直接报「文件已被占用」。DSN 的好处是直观但代价是绑定机器配置。同一份源码换一台电脑必须在新的系统里重新建 DSN 才能跑这在交付课程设计或给同事做演示时经常卡壳。2.3 无 DSN 连接一条连接串走天下DSN 本质上是写进注册表的一段配置既然只是一段配置那不如直接把它从注册表挪到代码里。常见做法是不在系统里建数据源直接把驱动和文件路径写进连接字符串CString strConn; strConn _T(Driver{Microsoft Access Driver (*.mdb)};) _T(DbqC:\\Work\\addresslist.mdb;); CDatabase db; if (!db.Open(_T(), FALSE, FALSE, strConn)) { AfxMessageBox(_T(连接数据库失败请检查 addresslist.mdb 路径)); return; }注意第二行 Dbq 的值是 MDB 文件的绝对路径路径里如果出现空格不需要额外加引号ODBC 驱动自己会处理。另外如果你用的系统装的是 Access 2016 及以上版本驱动名要写成Microsoft Access Driver (*.mdb, *.accdb)否则会提示找不到驱动。这个细节在第 4 章的排查里还会再提。连接串比 DSN 灵活所以现在的工程我一般首选无 DSN。它还有一个附带好处Debug 和 Release 环境下行为一致不会出现一边能连一边连不上的玄学问题。2.4 连上之后先验证表结构和字段名连接成功只是开始接下来要做的是确认数据库里到底有哪些表和字段。MDB 文件是 Jet 引擎管的你可以用 Access 打开 addresslist.mdb 直接看也可以用一段测试代码把表名打出来。下面这个写法适合快速验证连接CDatabase db; CString strConn; strConn _T(Driver{Microsoft Access Driver (*.mdb)};) _T(DbqC:\\Work\\addresslist.mdb;); db.Open(_T(), FALSE, FALSE, strConn); CRecordset rs(db); // 查询系统表拿到所有用户表名 rs.Open(CRecordset::forwardOnly, _T(SELECT Name FROM MSysObjects WHERE Type1 AND Name NOT LIKE MSys%)); while (!rs.IsEOF()) { CString strTable; rs.GetFieldValue((short)0, strTable); TRACE(_T(Table: %s\n), strTable); rs.MoveNext(); } rs.Close();这里用 MSysObjects 系统表来枚举用户表Type1 表示表对象过滤掉 MSys 开头的是为了避开 Jet 引擎自带的系统表。GetFieldValue按列的索引取字段值在字段名不确定时比GetFieldValue(字段名)更稳。跑完这段你至少能确认三件事连接串对不对、MDB 文件能不能读、表名叫什么。这个动作在整个工程里花不了五分钟却能省掉后面大把的排查时间。3. CRecordset 封装与增删改查从 PersonSet 到四个对话框连接通道打通之后真正的业务逻辑落在 PersonSet 和那几个对话框上。MFC 访问 ODBC 数据源的标准姿势是把数据表抽象成一个 CRecordset 派生类然后通过这个类的成员变量读写记录。3.1 PersonSet一张表对应一个记录集类PersonSet 是这个工程里最值得读的一个文件。它继承 CRecordset把 Contacts 表的每一列映射成一个 CString 成员。头文件的核心结构是这样class CPersonSet : public CRecordset { public: CPersonSet(CDatabase* pDatabase NULL); virtual CString GetDefaultConnect(); virtual CString GetDefaultSQL(); virtual void DoFieldExchange(CFieldExchange* pFX); CString m_strName; // 联系人姓名 CString m_strPhone; // 联系电话 CString m_strEmail; // 邮箱 CString m_strAddress; // 地址 CString m_strRemark; // 备注 };GetDefaultSQL返回表名DoFieldExchange负责把表的字段和成员变量绑定起来。当你在对话框里Open这个记录集的时候Jet 引擎按DoFieldExchange里写的绑定关系把当前记录的各列数据自动填充到成员变量里。3.2 添加与修改AddNew / Edit / Update 的标准节奏添加联系人时AddInfoDlg 里拿用户输入构造新记录。核心逻辑不复杂但顺序错了就会出幺蛾子我一般这么写// 假设 db 已经打开CPersonSet rs(db) CPersonSet rs(db); rs.Open(); rs.AddNew(); // 进入插入模式 rs.m_strName strName; rs.m_strPhone strPhone; rs.m_strEmail strEmail; rs.m_strAddress strAddress; rs.m_strRemark strRemark; rs.Update(); // 提交这次插入 rs.Close();这里的操作顺序是硬性的先AddNew()进入插入态然后赋值最后Update()提交。很多人第一次写会漏掉AddNew()直接给成员变量赋值结果保存后数据库里没有任何变化。原因在于 CRecordset 默认处于浏览模式只有显式调用AddNew()或Edit()后字段值才会被标记为待写入。修改联系人的逻辑几乎一模一样只是把AddNew()换成Edit()。区别在于Edit()之前要先定位到要改的那条记录也就是先MoveFirst或者Seek找到目标行再进编辑态。改完之后别忘了Update()这一步在 MFC 里不会自动提交。3.3 批量展示遍历记录集主界面的联系人列表是从 MainDlg 里遍历整个 Contacts 表填充的最直接的遍历方式是while (!rs.IsEOF())。这种写法在 MFC 里同时支持 Access、SQL Server 和 Oracle因为 CRecordset 帮你把不同数据库的游标行为统一了。rs.Open(); while (!rs.IsEOF()) { CString strLine; strLine.Format(_T(%s %s), rs.m_strName, rs.m_strPhone); m_list.AddString(strLine); rs.MoveNext(); }这里用MoveNext()驱动游标前进循环终止条件靠IsEOF()判断。注意如果记录集是空表IsEOF()在Open()之后直接就返回真不会进循环所以不需要额外判断。这个模式适合几百人规模的通讯录数据量再上去就该考虑分页或过滤了。3.4 搜索LIKE 模糊查询与参数拼接的边界SearchDlg 实现的是按姓名模糊搜索。SearchDlg 拿到用户输入后把 WHERE 条件拼进 SQL 再重新打开记录集CString strSQL; strSQL.Format(_T(SELECT * FROM Contacts WHERE Name LIKE %%%s%%), strKeyword); CRecordset rs(db); rs.Open(CRecordset::snapshot, strSQL);注意 MFC 的Format走的是 printf 系规则SQL 里的百分号%要写成%%才能输出成%。这条代码里两次%%最终拼出来的是%关键词%也就是标准的 LIKE 两侧模糊匹配。如果不转义Format会直接输出空或者报格式错误。这种字符串拼接的方式读起来直观但这个写法有一个边界要守住strKeyword 里如果带着单引号SQL 就会语法错误甚至可能被恶意拼接出额外条件。Access 数据库场景下常见的做法是先把单引号替换成两个单引号来转义strKeyword.Replace(_T(), _T()); strSQL.Format(_T(SELECT * FROM Contacts WHERE Name LIKE %%%s%%), strKeyword);Access 的 Jet 引擎对参数化查询的支持不如 SQL Server 顺手所以老工程里大量存在这种手工拼接。我看代码的习惯是输入来自对话框这种可信度偏低的场景先做转义再进 SQL这个动作成本极低能挡掉绝大多数意外。3.5 密码功能的处理逻辑PswdSet 和 ChangePswDlg 这套密码保护本质上还是在 MDB 里加了一张配置表存的是哈希后的口令。登录时把用户输入的密码走同样的哈希算法再去配置表里比对。修改密码对话框会先验证旧密码通过后才允许写入新值。这个模块可以单独抽出来复用到其他 MFC 工程里它不依赖通讯录的业务表只用到了前面说的那套连接通道和记录集操作。4. 避坑与排查连 MDB 时最常翻车的 5 个点这一章把我在类似工程里踩过的坑集中整理一下。每一条都是「现象 → 原因 → 解决」的结构你在复现时遇到同类问题可以直接照着处理。4.1 找不到数据源名或驱动现象代码写的是db.Open(_T(AddressListDSN), ...)运行时报「数据源名称未找到且没有指定默认驱动程序」。原因这台机器上根本没建过 AddressListDSN 这个数据源或者建到了 64 位的数据源管理界面里而你的程序是 32 位编译的。解决打开控制面板里的「ODBC 数据源32 位」重新建一个同名 DSN或者干脆改用第 2 章的无 DSN 连接串把驱动名和 Dbq 写死在代码里。我现在一律用无 DSN从源头绕开这个问题。4.2 连接串里写成 Provider 导致报错现象运行时报「初始化提供程序失败」或「无法找到可用的提供程序」。原因连接串写成了ProviderMicrosoft.Jet.OLEDB.4.0;Data Source...这是 ADO 的 OLEDB 连接方式不是 ODBC 的驱动方式。你在 MFC 里用 CDatabase 走的是 ODBC 接口只能认Driver开头的连接串。解决把连接串改回Driver{Microsoft Access Driver (*.mdb)};Dbq...如果确实想用 OLEDB那就改用_ConnectionPtr之类的 ADO 接口两条技术路线不能混着写。4.3 CRecordset 重复 Open现象程序第二次执行查询时报「记录集已打开」或 CDBException 弹窗。原因同一个 CRecordset 对象在没Close()的情况下又调用了一次Open()Jet 引擎不允许记录集处于打开状态时再次打开。解决每次Open()用完配对Close()或者在Open()之前先判断一下IsOpen()已经打开就先Close()。一个更省心的习惯是每次查询都新建一个局部 CRecordset 对象用完即销毁生命周期一结束句柄自动释放。4.4 中文乱码现象写入 Access 的中文正常但从记录集读出来显示成乱码。原因VC 6.0 默认是 ANSI 编译源文件如果被保存成了 UTF-8中文字符串常量会被编译器按 ANSI 解读整个字面量就错了。另一个常见原因是 Access 表字段本身存的数据编码与程序读取代码页不一致。解决源文件统一用 ANSI 编码保存所有的字符串字面量用_T()包裹。读取时如果还乱检查 MDB 里那条记录是不是在别的程序里用 UTF-8 写进去的是的话统一用 Access 打开重新编辑一下。这个问题一旦出现优先怀疑编码而不是怀疑数据库。4.5 记录集只读Update 报错现象Update()时报「记录集是只读的」或者「无法更新」。原因打开记录集时用了CRecordset::readOnly或者 MDB 文件在磁盘上被设置了只读属性再或者记录集的快照类型选错了。解决先检查Open()的第一个参数有没有传CRecordset::readOnly有就改成snapshot或dynaset然后右键 MDB 文件看属性把只读勾去掉。还有一个隐藏场景文件在 U 盘或网络共享目录里被占用也会表现成只读把文件拷到本地再试一次就能区分。5. 进阶技巧把通讯录工程改成通用的 MDB 查询工具工程跑通之后下一步不是急着加功能而是把连接和排错这两件事固化下来。第一个建议是把连接串从散落的对话框代码里收拢到一处。常见做法是在 PersonSet 的GetDefaultConnect()里统一写无 DSN 连接串这样所有用这个记录集的地方都不再关心连接细节。CString CPersonSet::GetDefaultConnect() { return _T(Driver{Microsoft Access Driver (*.mdb)};) _T(DbqC:\\Work\\addresslist.mdb;); }第二个建议是给所有Open()和Update()包一层异常处理。MFC 用 CDBException 抛数据库错误哪怕你不处理程序也会弹一个极不友好的英文错误框信息量还少。我一般会在catch (CDBException* e)里把e-m_strError和e-m_strStateNativeOrigin拼在一起弹出来这两段信息一个描述错误原因一个给出 ODBC 状态码和原生错误码排查时比只看返回值有用得多。第三个建议是从验证方法上偷懒准备一个独立的测试入口里面依次执行「连接 → 读表结构 → 查一条 → 插入一条 → 删除一条」每一步都在日志里打输出。这个测试入口不需要进主界面直接在InitInstance里用一个命令行参数触发就行。这样每次改动连接串或表结构跑一轮测试就能定位问题不用反复打开对话框点来点去。我第一次做这类改造时最大的教训是把连接串写在 MainDlg 的初始化函数里换一台机器演示前以为路径肯定没问题结果现场翻车当着别人的面改了三次代码才连上库。从那以后我每接一个 MDB 相关工程都强制先走一遍「连接串 → 表结构 → 最小查询 → 增删改」的验证流程再开始动业务代码。这套验证顺序花不了十分钟但能把百分之八十的玄学问题提前拦下来。希望帮到你。本文还有配套的精品资源点击获取