C#宾馆管理系统课设实战：WinForms+ADO.NET+SQL Server全解析

简介一份基于C#的小型宾馆管理系统完整项目内含数据库文件与实验报告面向计算机专业学生及课程设计开发者。系统覆盖Windows Forms界面、ADO.NET数据库连接、业务逻辑与数据访问分层典型展示C#桌面应用开发流程适合学习WinForms与SQL Server交互的读者参考复现。压缩包共121个文件约9.84MB以C#源文件44个cs和VS资源文件15个resx/Designer为主同时包含SQL脚本、exe可执行程序、DLL依赖及实验报告doc其中SQL脚本可直接建库doc报告详细记录开发过程与实现思路便于直接运行与对照代码学习。已有210人学习使用。项目文件结构完整从FormMain、FormCheckIn等窗体到Roomer管理模块配合数据库脚本和报告文档可为用户提供从需求分析、界面设计到数据操作的完整范例是巩固面向对象编程与数据库开发技能的实用素材。1. 先聊聊这套C#宾馆管理系统一个课设Demo能给你什么这套基于C#的宾馆管理系统是典型的课程设计项目WinForms界面、ADO.NET连库、SQL Server存数据外加一份实验报告。它不是生产级的酒店PMS没有会员体系、没有扫码入住但它把「客户端程序该怎么和数据库打交道」这件事完整地走了一遍。对于还在学C#、正在找课设题目的同学或者想快速捡起WinFormsADO.NET这套老技术栈的开发者这是性价比很高的参考物。项目里能直接看到窗体设计器生成的Designer.cs、数据库文件、还有老师要求的实验报告长什么样。你要做的是把代码跑起来看懂每条线是怎么串的然后改成你自己题目的样子。我拆这类项目拆得多这套源码值得下下来对着撸一遍。2. 数据库设计是起点四张表、连接字符串与SqlCommand参数化很多同学拿到这种项目第一反应是打开FormMain.cs看界面代码结果越看越晕。我的习惯是先看数据库文件数据结构理顺了代码基本就通了一半。宾馆管理系统的核心数据模型并不复杂但表之间的关系和状态流转是理解整个系统的钥匙。2.1 表结构设计宾馆管理最少要几张表这套项目的数据库文件一般有两种形态SQL Server的.mdf/.bak或者Access的.mdb。看项目引用里有没有System.Data.SqlClient有就是SQL Server要是用OleDb那就是Access。以最常见的SQL Server版本为例核心表通常是这几张CREATE TABLE Room ( RoomID INT IDENTITY(1,1) PRIMARY KEY, RoomNO VARCHAR(10) NOT NULL UNIQUE, RoomType VARCHAR(20) NOT NULL, Price DECIMAL(10,2) NOT NULL, Status INT NOT NULL DEFAULT 0 ); CREATE TABLE Guest ( GuestID INT IDENTITY(1,1) PRIMARY KEY, GuestName NVARCHAR(20) NOT NULL, IDCard VARCHAR(18) NOT NULL, Phone VARCHAR(11) ); CREATE TABLE CheckIn ( CheckInID INT IDENTITY(1,1) PRIMARY KEY, RoomID INT NOT NULL, GuestID INT NOT NULL, CheckInTime DATETIME NOT NULL, CheckOutTime DATETIME NULL, Deposit DECIMAL(10,2) DEFAULT 0, FOREIGN KEY (RoomID) REFERENCES Room(RoomID), FOREIGN KEY (GuestID) REFERENCES Guest(GuestID) );这里说几个需要注意的点房间状态Status用int而不是字符串0代表空闲、1代表已入住、2代表脏房/打扫中这样在下拉框和条件查询里都好处理不会出现中英文混写导致匹配不上的问题。价格用DECIMAL(10,2)这是成败关键后面讲房费计算时会展开。Guest表里身份证号IDCard用VARCHAR而不是NVARCHAR因为身份证是纯数字和字母不需要Unicode支持。表结构能看出什么订单是CheckIn表它同时关联Room和Guest这个设计意味着一个客人可以开多个房间每个房间一条记录也可以一个房间被不同客人先后入住时间错开这是宾馆的基本场景。但要注意这套表结构里没有单独的「订单明细」表也没有「消费项目」表如果你要改成带矿泉水、洗衣费的版本就得自己加表。2.2 连接字符串为什么总有人连不上数据库连接字符串是WinForms项目的第一个大坑。这套项目里最常见的是写死在App.config里的连接字符串或者直接在代码里拼。典型写法如下connectionStrings add nameHotelDB connectionStringData Source.;Initial CatalogHotelDB;Integrated SecurityTrue providerNameSystem.Data.SqlClient / /connectionStrings读出来的代码也很固定一般封装成一个DBHelper类public static SqlConnection GetConnection() { string connStr ConfigurationManager.ConnectionStrings[HotelDB].ConnectionString; SqlConnection conn new SqlConnection(connStr); return conn; }注意这几个参数Data Source的.代表本机默认实例如果你装的是命名实例比如localhost\SQLEXPRESS这里就必须写localhost\SQLEXPRESS这是90%的「数据库连不上」报错根源。Integrated SecurityTrue用的是Windows身份验证如果目标机器上SQL Server只开了混合验证这个连接串也会失败需要改成User IDsa;Passwordxxx。我一般拿到这种项目第一步不会是去跑程序而是先拿SQL Server Management Studio试着连一次这个库。SSMS能连上程序连不上那就是代码问题SSMS都连不上那是环境问题别急着改代码。2.3 SqlCommand参数化防止注入和日期格式坑看这种课设项目我最关心的是SQL语句怎么写。老版本的项目经常看到字符串拼接SQL比如string sql SELECT * FROM CheckIn WHERE GuestName txtName.Text ;这种写法在课程设计里能跑但有两个隐患一是SQL注入二是当输入里带单引号时直接报错。正确的做法是用SqlParameter参数化string sql SELECT * FROM CheckIn WHERE GuestName name; SqlCommand cmd new SqlCommand(sql, conn); cmd.Parameters.AddWithValue(name, txtName.Text.Trim()); SqlDataAdapter da new SqlDataAdapter(cmd); DataTable dt new DataTable(); da.Fill(dt); dataGridView1.DataSource dt;这段代码的逻辑是先构造带占位符的SQL再用Parameters填充值最后通过SqlDataAdapter把结果填充到DataTable里直接绑定给DataGridView显示。参数化的好处不只是防注入——它还强制把日期、数字按类型传入避免把2024-01-02这种字符串丢给数据库时被区域设置影响。AddWithValue虽然方便但在字段是DECIMAL或DATETIME时建议改用cmd.Parameters.Add(price, SqlDbType.Decimal).Value price更稳。3. 窗体与主流程FormMain跳转FormCheckIn参数怎么传数据层理顺了接下来看界面层。WinForms项目的代码量大多集中在窗体里FormMain是主窗体FormRoomer是客人管理FormCheckIn是入住登记。这套项目的主流程是这样的主窗体加载房间状态列表点击某个房间触发入住操作弹出入住窗体填完信息保存后刷新房间状态。这里面的关键在于窗体之间怎么传值。3.1 主窗体FormMain加载房间状态的两种姿势主窗体的核心是房间列表的展示。常见做法是放一个DataGridView或者用FlowLayoutPanel动态生成一排房间卡片。加载代码一般长这样private void FormMain_Load(object sender, EventArgs e) { LoadRoomStatus(); } private void LoadRoomStatus() { string sql SELECT RoomNO, RoomType, Price, Status FROM Room ORDER BY RoomNO; DataTable dt DBHelper.ExecuteQuery(sql); dataGridViewRooms.DataSource dt; // 给状态列显示中文 for (int i 0; i dt.Rows.Count; i) { int status Convert.ToInt32(dt.Rows[i][Status]); dataGridViewRooms.Rows[i].Cells[ColStatus].Value status 0 ? 空闲 : (status 1 ? 已入住 : 打扫中); } }这里有个容易被忽略的点把整张Room表绑到DataGridView上状态列显示的是0/1/2用户根本看不懂。常见做法是上面这样遍历行去替换显示文本但更好的做法是在SQL层就用CASE把状态翻译成中文SELECT RoomNO, RoomType, Price, CASE Status WHEN 0 THEN N空闲 WHEN 1 THEN N已入住 ELSE N打扫中 END AS StatusText FROM Room两种做法效果一样但第二种把展示逻辑放在SQL里C#代码更干净。缺点是如果后面要按状态数字筛选还是得保留原始Status字段所以很多项目干脆两个字段都查出来一个用来显示一个用来判断。3.2 入住窗体FormRoomer下拉框绑定与缺省值入住窗体的典型布局是显示所选房号、选择客人或新建客人、设置押金、点保存。客人选择这块老项目喜欢用一个ComboBox从Guest表拉数据string sql SELECT GuestID, GuestName FROM Guest; DataTable dt DBHelper.ExecuteQuery(sql); cmbGuest.DataSource dt; cmbGuest.DisplayMember GuestName; cmbGuest.ValueMember GuestID;这三行配置很关键DisplayMember决定用户看到什么ValueMember决定选中后你拿到什么。后面取选中值时用cmbGuest.SelectedValue拿到的就是GuestID了不用再解析文本。这里有个坑如果Guest表是空的下拉框里什么都没有所以很多项目会加一个「新客人」按钮点击后弹出一个小窗体录入客人信息保存后重新绑定下拉框。这类代码的价值不只是「能跑」它在教你一个交互模式主从表数据在界面上的联动刷新。3.3 房间选择与传参FormCheckIn怎么拿到房号主窗体点击一个房间弹出入住窗体房号怎么传过去最简单的做法是给入住窗体加一个有参构造函数public partial class FormCheckIn : Form { private string _roomNo; private int _roomId; public FormCheckIn(string roomNo, int roomId) { InitializeComponent(); _roomNo roomNo; _roomId roomId; } private void FormCheckIn_Load(object sender, EventArgs e) { txtRoomNo.Text _roomNo; // 可以根据_roomId去查房价等信息 } }调用处就更简洁了FormCheckIn frm new FormCheckIn(roomNo, roomId); frm.ShowDialog(); LoadRoomStatus(); // 关闭后刷新列表用有参构造函数传参比在窗体里挖空心思找控件赋值要干净得多。ShowDialog后面紧跟刷新是因为入住保存完成后主窗体必须立刻反映房间状态变化。有些项目会犯懒不做这一步结果入住完还要手动刷新体验很差。4. 入退房的核心逻辑房价计算、状态机与并发入住前台功能里最容易翻车的就是房价计算和房间状态更新。这两块逻辑不复杂但边界条件多。我拆过的宾馆管理课设里十有八九在退房时房费算错或者在并发操作时出现一个房间开两单的情况。4.1 房价计算DateTime差值与decimal精度先看退房时的费用计算代码这是最常见的写法DateTime checkInTime Convert.ToDateTime(dtRow[CheckInTime]); DateTime checkOutTime DateTime.Now; // 按天算不满一天按一天算 TimeSpan span checkOutTime - checkInTime; int days span.Days; if (span.Hours 0 || span.Minutes 0) { days 1; } decimal price Convert.ToDecimal(dtRow[Price]); decimal total price * days;这段逻辑有三个隐藏问题。第一TimeSpan.Days在跨月或跨年时不代表真实的「自然日」天数比如2月1日入住到3月1日退房按TimeSpan算出来是28天或29天但按自然日应该是28或29天问题不大真正的问题是如果入住时间恰好是23:00第二天凌晨2:00退房用户住了一晚按小时算不满24小时按自然日算应该是2天跨了两个日期这里容易扯皮。常见做法是只比较日期部分而不是时间部分。第二直接用DateTime.Now去减会掺杂机器时间。正确做法是让SQL Server返回时间SELECT GETDATE()。原因很简单应用服务器的时间和数据库服务器的时间可能不一致。不过课设通常同一台机器影响不大。第三用double类型算钱是新手常见错误。double的浮点表示会导致类似0.10.2不等于0.3的问题。我见过有项目用float存房价退房时显示99.999999客人投诉。正确做法是所有金额一律用decimal这也是前面建表时强调DECIMAL(10,2)的原因。4.2 房间状态机空闲、已入住与脏房房间状态流转是整个系统的核心逻辑它应该是一个严格的状态机空闲(0) → 已入住(1)客人办理入住已入住(1) → 脏房(2)客人退房房间待打扫脏房(2) → 空闲(0)保洁打扫完成房间可售这个流转在代码里对应着三次UPDATE语句。入住时string sql UPDATE Room SET Status 1 WHERE RoomID roomId AND Status 0;注意这里的AND Status 0不是多余的它是一个并发保护条件——只有房间当前是空闲状态时才能置为已入住如果已经被别人抢先入住这个UPDATE影响的行数是0程序就能据此提示「房间已被占用」。这是防止一房两单最便宜的做法。退房时同理string sql UPDATE Room SET Status 2 WHERE RoomID roomId AND Status 1;把状态先置为脏房而不是直接置为空闲这个设计我很喜欢。它模拟了真实酒店的工作流退房之后保洁要打扫打扫完才能卖给下一位客人。很多课设项目直接把房间置为空闲少了一张「打扫中」的状态虽然功能上也能跑但少了这层设计就少了业务上的合理性答辩时老师一问就露怯。4.3 并发入住一房两单怎么防上面说的AND Status 0是一种乐观并发控制。但注意这还不够。完整的入住流程应该在一个事务里完成using (SqlTransaction tx conn.BeginTransaction()) { try { // 1. 插入入住记录 string sqlCheckIn INSERT INTO CheckIn (RoomID, GuestID, CheckInTime, Deposit) VALUES (roomId, guestId, GETDATE(), deposit);; // 2. 更新房间状态 string sqlUpdateRoom UPDATE Room SET Status 1 WHERE RoomID roomId AND Status 0; SqlCommand cmd1 new SqlCommand(sqlCheckIn, conn, tx); SqlCommand cmd2 new SqlCommand(sqlUpdateRoom, conn, tx); int affected cmd2.ExecuteNonQuery(); if (affected 0) { tx.Rollback(); MessageBox.Show(房间状态已变化请刷新后重试); return; } cmd1.ExecuteNonQuery(); tx.Commit(); } catch { tx.Rollback(); throw; } }事务存在的意义是如果插入入住记录成功但更新房间状态失败两个操作必须同时回滚否则会出现「客人信息存在但房间没入住」的数据脏状态。判断affected 0的时机要在更新房间状态之后、提交事务之前。很多人会把顺序搞反——先更新状态再插入记录或者干脆不检查返回值这两种都埋了雷。另外还要提一下DataGridView的行选择状态也是并发问题的来源。用户双击一个房间弹出入住窗体这个期间没有人能操作主窗体因为ShowDialog是模态的所以UI层面的并发问题在这个项目里并不严重。真正的威胁来自多台收银机同时操作同一个库这时事务和状态条件的价值就体现出来了。5. 常见问题与避坑编译不过、数据库附加失败、缓存残留这类课设项目从下载到跑通中间隔着好几道坎。我按踩坑的频率排个序基本都是我帮人看项目时反复遇到的问题。5.1 现象用Visual Studio打开项目报一堆ResolveAssemblyReference.cache错误首先是编译层面。你会在项目文件夹里看到ResolveAssemblyReference.cache、DesignTimeResolveAssemblyReferencesInput.cache这些文件它们不是源码是Visual Studio在编译时生成的临时缓存文件。如果这些文件损坏、或者它们记录的引用和当前环境不一致VS会报一些莫名其妙的引用错误比如「未能找到类型或命名空间」。原因是这些cache文件记录了上一次编译时程序集的解析结果很多同学把项目打包发人时没清理这些文件下载者用不同版本的VS打开VS尝试复用旧缓存但路径对不上。解决方法是手动清理关掉VS删除bin、obj、Debug目录以及所有.cache文件重新打开工程。如果还报错检查项目文件里的引用路径是不是指向了本机特定位置的DLL。我在处理这种项目时一般会先删缓存再开不删缓存就编译容易看到假报错。5.2 现象附加数据库失败提示版本号高于当前SQL Server很多课设用的数据库文件是.mdf直接在VS里附加或用SSMS附加时提示「文件版本655无法附加」。这通常是因为对方用的是较新版本SQL Server比如2019/2022而本机是SQL Server 2012或2014低版本无法附加高版本生成的数据库文件。解决办法有两条路。一是换用本机能跑的最高版本SQL Server或者去装一个SQL Server 2022 Express把.mdf附加进去。二是让发给你项目的人把数据库导出成.bak备份文件或者生成创建脚本Script Database → Generate Scripts你本地执行脚本重建数据库。更省事的方式是直接把数据库转成Access用OleDb连接不受版本限制。从资源包里看如果是这个.mdf文件跟你本机不兼容我建议先查一下.mdf的版本匹配不上再走脚本重建。5.3 现象程序能编译但运行时连不上数据库报「网络相关或特定实例错误」这是最常被问到的问题原因基本都出在连接字符串的Data Source上。我把数据库附加到本机SQL Server后第一次跑程序它报错说找不到服务器。原因是项目里写死的连接字符串比如Data Source.;Initial CatalogHotelDB;Integrated SecurityTrue它指向的是对方机器上的SQL Server。你本机的实例名可能不是默认实例是个带版本后缀的命名实例比如localhost\SQLEXPRESS。解决方法是打开项目里的App.config或者Web.config / Settings.settings把Data Source改成自己机器的实例名。检查方法也很简单在SQL Server Management Studio登录窗口就能看到服务器名照着填进去就行。如果你装了多个版本的SQL Server还要注意默认实例和命名实例的区别一个冒号加实例名的写法写错就白干。我一般会在DBHelper里加一个小函数要么允许从配置读取要么自动探测localhost\SQLEXPRESS和.两种写法省得每次换电脑都改代码。5.4 现象退房时房费算出来是负数某次我跑一个改过的版本客人当天入住当天退房房费居然是负数后面一查发现是时间相减方向搞反了。原因是退房时间取的字段并不是实际的退房时间而是误取了CheckInTime。也就是说代码里查出来的两列都是退房时间或者赋值时变量写反了比如把Convert.ToDateTime(dtRow[CheckInTime])和Convert.ToDateTime(dtRow[CheckOutTime])写反了。解决方法是在SQL查询里把两个时间的列名都打出来检查数据源里到底哪个字段有值。很多表设计里CheckOutTime字段允许NULL退房时才写入。如果查询语句里没有把CheckOutTime查出来前端就永远取不到退房时间退房操作就没法算费。我给这类项目补的常规操作是退房按钮的Click事件里先更新CheckIn表的CheckOutTime字段再重新查询计算费用两步在一个事务里完成就不会出现负数和零费用。5.5 现象改了代码但运行时还是老界面怎么看都是旧版本这是很迷惑的「玄学」问题——明明改了FormMain里的文本运行起来还是老样子。原因是Visual Studio Debug模式下程序集缓存在bin\Debug目录里有时候编译没有完全覆盖或者你运行的是旧进程的残留。特别是带Designer.cs的窗体如果之前运行的程序没有退出还在后台占用着EXE文件新的编译就会失败或跳过。解决方法是先确认所有宿留的进程退出CtrlShiftEsc看进程列表有没有残留的程序名然后右键项目 → 重新生成而不是生成。如果还不行手动删掉bin和obj目录再生成。养成习惯之后我再也不信「改了没生效」这种话基本都是编译输出目录的旧文件在捣鬼。6. 结课提交前做一遍冒烟从开房到退房全流程验证最后的验证阶段我有一套固定的冒烟流程照着走一遍系统有没有问题基本心里有数。先说步骤再说实验报告怎么写能让老师给高分。冒烟测试的路径是这样先打开主窗体确认房间列表能加载然后点一个空闲房间办理入住选客人或新建客人填押金和入住时间保存后回主窗体看房间状态是不是变成「已入住」。接着再对这个房间做一次「误操作」测试再点入住这时候应该提示房间已被占用或者不允许打开入住窗体——这一步是验证状态机有没有生效。最后办理退房确认房费计算正确、房间状态变成「打扫中」。如果系统里有「打扫完成」按钮点一下让房间回到「空闲」整个链路就闭环了。这套流程跑完数据库里应该能看到一条完整的CheckIn记录CheckInTime有值、CheckOutTime有值Room的状态从0走到1再到2再到0。如果中途哪一步卡住优先看是不是SQL语句里漏了条件。实验报告方面这份报告的核心价值在于把开发过程和问题解决方案讲清楚。我一般建议报告按这样的顺序展开需求分析系统要解决什么问题→ 数据库设计表结构说明要用表格列清楚→ 模块划分画出窗体导航逻辑→ 核心代码说明选关键功能贴代码并逐行解释→ 测试过程把冒烟流程截图放进去→ 遇到的问题与解决。很多同学写报告只会贴代码截图这其实是最亏的。老师最想看到的是「你遇到了什么问题、怎么定位、怎么解决」——比如连接不上数据库后怎么排查的细节这个东西最能体现工作量。最后提醒一句提交前确认项目文件里有数据库文件和实验报告但ResolveAssemblyReference.cache这类临时缓存直接删掉不要打包进去。我就是有一次没清理干净老师在另一台机器上打开报错邮件来回两趟才解决。从那以后我每次发源码包之前都会强制走一遍「清理解决方案 → 删除bin和obj → 删.cache → 再压缩」的流程。希望帮到你这套系统值得你下下来从头跑到尾跑通了C#这门课的课设基本就稳了。本文还有配套的精品资源点击获取