简介面向具备基础C#语法、希望掌握数据库操作的初级开发者WPF数据库交互实践包演示了在WPF应用中通过SQL Server完成增删改查CRUD的完整流程涵盖SqlConnection连接、参数化SqlCommand执行、DataTable/DataGrid数据绑定以及MVVM与事务处理的进阶思路。压缩包内共56个文件以21个cs源码和6个xaml界面文件为核心配合baml、exe、pdb等项目生成物与sln解决方案文件整体大小仅95KB便于直接解压后对照工程文件学习。目前已有2212人下载学习适合正在学习C#桌面开发或需要快速搭建数据库操作例程的开发者。通过源码、界面布局与可执行程序对照能直观理解连接字符串配置、SQL语句拼接、参数防注入及异常处理等关键环节增删改查各功能模块均有对应的窗体与后台代码可方便地直接改造为更复杂的学生管理或进销存项目。1. WPF链接数据库做增删改查一套SqlHelper能撑十年把WPF界面和SQL Server数据库连起来做增删改查是很多C#桌面工程师上班第一天就要面对的事。你可能搜过WPF连接数据库WPF增删改查网上教程要么只讲Ado.Net原生代码要么直接甩出一个包着数据库逻辑的MVVM框架看得人一头雾水。其实这套东西的内核一直很稳定你有一个界面用户点按钮程序拼出一条SQL把数据库里的记录拿出来放到表格里或者把界面上的输入写回数据库。适合做企业内部工具、上位机数据管理、轻型ERP客户端新手能用三步把流程跑通熟手能在这套骨架上应对并发、事务和SQL注入。我做了几年WPF客户端最深的体会是不要急着上重型ORM先把最朴素的SqlConnection和SqlParameter用明白后面所有坑都能看得见。2. 先搭数据访问层连接字符串、SqlConnection与可复用的SQL助手类2.1 为什么首选手写SQL而不是一上来就上EF或Dapper很多新项目喜欢把Entity Framework当作标配但WPF桌面项目里我一般会劝你在前期多想想。EF Core在Web项目里管理模型迁移很爽到了WPF客户端却常遇到一个尴尬项目要部署到几十台工控机上数据库是客户那边的SQL Server 2008 R2版本老、权限不开放EF生成的SQL语句DBA根本不让过。Dapper轻量但它只帮你做映射SQL还得自己写。既然SQL逃不掉不如直接用Ado.Net把数据访问层收拢成一个十来行的助手类。这个选择还有一个现实好处WPF的数据绑定强烈依赖DataTable和DataRow而SqlDataAdapter天生输出DataTable不需要中间做任何对象转换。写SQL时你心里要清楚执行计划数据的流向全部可控出了问题看SQL Server Profiler一眼就能抓到不会在ORM的黑匣子里翻车。2.2 App.config里配置连接字符串注意版本和参数连接字符串是数据库操作的第一道关卡很多连接不上的问题都出在这。建议把连接字符串放在App.config的connectionStrings节点里不要硬编码在代码中。一个典型的SQL Server连接串长这样connectionStrings add namemssql connectionStringData Sourcelocalhost;Initial CatalogDemoDB;User IDsa;Password123456;MultipleActiveResultSetstrue;TrustServerCertificatetrue; providerNameSystem.Data.SqlClient/ /connectionStrings这里三个参数容易踩坑。第一Data Source如果是本机实例写.或localhost命名实例要写成localhost\SQLEXPRESS第二User ID和Password属于SQL Server身份验证如果客户环境用的是Windows身份验证就改成Integrated SecurityTrue不要再塞账号密码第三TrustServerCertificatetrue是给新版驱动用的老驱动对本地证书校验不严加上它能在测试环境省去很多连接报错。我在接入现场数据库时就因为少了这个参数浪费过一下午。注意providerName要保留之后做设计器生成数据集时还要靠它识别驱动。2.3 写一个能查能增删改的SqlHelper类搭建数据访问层的核心是提供一个类把打开连接、执行命令、关闭连接这些重复劳动全部吃掉。网上流传的版本特别多但核心就是两个方法一个是查询返回DataTable一个是执行增删改返回受影响行数。using System; using System.Data; using System.Data.SqlClient; using System.Configuration; public class SqlHelper { private static readonly string ConnStr ConfigurationManager.ConnectionStrings[mssql]?.ConnectionString; public static DataTable Query(string sql, params SqlParameter[] parameters) { using (var conn new SqlConnection(ConnStr)) using (var cmd new SqlCommand(sql, conn)) using (var adapter new SqlDataAdapter(cmd)) { if (parameters ! null) cmd.Parameters.AddRange(parameters); DataTable dt new DataTable(); adapter.Fill(dt); return dt; } } public static int Execute(string sql, params SqlParameter[] parameters) { using (var conn new SqlConnection(ConnStr)) using (var cmd new SqlCommand(sql, conn)) { if (parameters ! null) cmd.Parameters.AddRange(parameters); conn.Open(); return cmd.ExecuteNonQuery(); } } }这里的逻辑不复杂但有几个细节值得讲清楚。using块保证连接和命令用完后自动释放不用手写conn.Close()params SqlParameter[]把参数数组作为可变参数传入调用方可以直接写成new SqlParameter(id, 1)代码更清爽。查询方法走SqlDataAdapter它会自己去打开连接再关闭连接所以没有显式Open()执行方法要返回受影响行数必须手动conn.Open()。两个方法都返回了后来界面要用的结果DataTable直接给表格绑定int告诉界面刚才改了几行。这个类我已经用了好几年换MySQL只要把类里的Sql换掉再用MySql.Data重写一遍其余代码几乎不用动。2.4 快速验证写第一个查询命令搭好助手类后别急着画界面先在MainWindow的构造方法里跑通一条查询确认连接串和类都正常。这个步骤能帮你隔离问题如果连控制台层面都查不出来就别浪费时间拖界面了。public MainWindow() { InitializeComponent(); string sql SELECT Id, Name, CreateTime FROM Products ORDER BY CreateTime DESC; DataTable dt SqlHelper.Query(sql); MessageBox.Show($共查出 {dt.Rows.Count} 条记录); }运行起来如果弹出条数说明连接没问题。如果这里报错第一反应看异常信息Login failed for user是账号错A network-related or instance-specific error是地址或端口不通Cannot open database是库名不对。把这些异常记下来第五部分我会逐个讲。查询方法接收原样SQL字符串不需要额外处理参数因为这里没有拼接用户输入。3. DataGrid增删改查落地查询、新增、修改、删除的完整代码路径3.1 界面上摆一个DataGrid把数据绑定上去WPF的DataGrid是一个很省心的控件绑定DataTable后会自动生成列配合WPF数据绑定机制表格更新只靠重新赋值ItemsSource。界面布局我习惯用Grid划分成上下两块上面是查询条件的Panel下面是DataGrid右侧竖排四个按钮查询、新增、修改、删除。Grid Margin10 Grid.RowDefinitions RowDefinition HeightAuto/ RowDefinition HeightAuto/ RowDefinition Height*/ /Grid.RowDefinitions StackPanel Grid.Row0 OrientationHorizontal Margin0,0,0,8 TextBox x:NametxtKeyword Width160 Margin0,0,8,0/ Button Content查询 Width70 ClickBtnQuery_Click/ /StackPanel DataGrid x:NamegridData Grid.Row2 AutoGenerateColumnsTrue SelectionModeSingle IsReadOnlyTrue/ /Grid这段XAML里AutoGenerateColumnsTrue会自动把DataTable的每列显示出来适合快速开发。但如果你遇到列顺序乱、列名是英文而界面要显示中文就把AutoGenerateColumns改成False手动加DataGridTextColumn并绑定Binding PathName。注意DataGrid默认是整行选中点击单元格时SelectedItem拿到的是一整行数据不是单元格后面的修改和删除都要靠这个行数据推进。IsReadOnlyTrue能防止用户直接在表格里改数据我们统一走弹窗或表单这样可以控制写入逻辑避免把脏数据直接灌进库。3.2 查询按钮把条件换成参数再查查询是整张页面的骨架按钮单击事件里把关键字文本框的值转成参数然后调用SqlHelper.Query。这里有个WPF新手的经典错误以为DataGrid.ItemsSource dt之后调用Refresh()就万事大吉其实换了新的DataTable必须重新赋值。private void BtnQuery_Click(object sender, RoutedEventArgs e) { string keyword txtKeyword.Text.Trim(); string sql SELECT Id, Name, Price, Stock, CreateTime FROM Products WHERE Name LIKE keyword OR Code LIKE keyword ORDER BY CreateTime DESC; var p new SqlParameter(keyword, $%{keyword}%); DataTable dt SqlHelper.Query(sql, p); gridData.ItemsSource dt; }这里把%和关键字拼成一个字符串作为参数值传给SQL而不是写成LIKE %keyword%因为参数占位符本身没有通配符能力。这样写还有一个额外好处作废查询条件时只要把WHERE改成WHERE 11再按条件追加就可以了。SQL里出现两条LIKE keyword如果我想支持按名称或编码模糊查只需要传同一个参数名两次SqlParameter会自动覆盖不需要再建第二个参数。改参数时保持变量名p的前提下多条件可以继续往方法里追加new SqlParameter(type, type)。3.3 新增和修改统一走弹窗还是写死表单新增和修改的逻辑很像都是取窗口输入框的值构造参数然后执行Insert或Update。经验是把它们写在一对方法里差别只在于SQL语句和是否带主键。常见的做法是单独做一个ProductEditWindow做弹窗主窗口只负责调用但为了演示完整路径我们直接在MainWindow里用输入框临时解决。private void BtnAdd_Click(object sender, RoutedEventArgs e) { string name txtName.Text.Trim(); decimal price decimal.Parse(txtPrice.Text.Trim()); string sql INSERT INTO Products(Name, Price, Stock, CreateTime) VALUES(name, price, stock, GETDATE()); var rows SqlHelper.Execute(sql, new SqlParameter(name, name), new SqlParameter(price, price), new SqlParameter(stock, int.Parse(txtStock.Text.Trim()))); if (rows 0) { MessageBox.Show(新增成功); BtnQuery_Click(sender, e); } } private void BtnUpdate_Click(object sender, RoutedEventArgs e) { if (gridData.SelectedItem is DataRowView row) { int id (int)row[Id]; string sql UPDATE Products SET Namename, Priceprice, Stockstock WHERE Idid; SqlHelper.Execute(sql, new SqlParameter(name, txtName.Text.Trim()), new SqlParameter(price, decimal.Parse(txtPrice.Text.Trim())), new SqlParameter(stock, int.Parse(txtStock.Text.Trim())), new SqlParameter(id, id)); BtnQuery_Click(sender, e); } }这里有个WPF老手才会注意的细节gridData.SelectedItem拿到的不是DataRow而是DataRowView因为它绑定的是DataTable默认视图。取列值要row[Id]而不是((DataRow)row)[Id]。第一次封装这个逻辑的新手十有八九会在这里翻车。修改按钮把主键Id放在最后传是因为SQL里id用得最晚参数顺序其实无所谓只是方便阅读。无论增还是改操作成功后都要重新执行查询让界面和数据库保持一致这也是最朴素的同步策略。如果有部门想做得更顺手就把Price和Stock的两个文本框做成只影响当前行选中行时自动回填。3.4 删除确认弹窗、主键参数与DataRowView取值删除操作最害怕的就是误删界面上一定要有确认环节。SQL本身很简单DELETE FROM Products WHERE Idid但取值方式却和界面上显示的表格列有关。如果你的表格不是绑定主键列取值就会成问题所以最稳的方式是取出当前行的主键字段。private void BtnDelete_Click(object sender, RoutedEventArgs e) { if (gridData.SelectedItem is DataRowView row) { if (MessageBox.Show($确定删除编号 {row[Id]} 的产品吗, 删除确认, MessageBoxButton.YesNo, MessageBoxImage.Question) MessageBoxResult.Yes) { int id (int)row[Id]; SqlHelper.Execute(DELETE FROM Products WHERE Idid, new SqlParameter(id, id)); BtnQuery_Click(sender, e); } } }删除前取整行数据不仅能确认主键还能顺便确认名称等关键字段。在IsReadOnly的DataGrid上SelectedItem只要选中行就一定有值不需要判空但在动态添加数据时要注意列表清空后SelectedItem会变为null。另外如果数据库里的表存在外键约束删除被引用的主表记录会直接抛异常提示The DELETE statement conflicted with the REFERENCE constraint这在客户老系统里非常常见。解决办法是先在子表里删干净或者干脆在数据库里设置级联删除但级联删除容易误伤我一般建议先查引用再删。4. 参数化查询与SQL注入防御三个必改的写法与事务边界4.1 字符串拼接是在给数据库留后门WPF项目里最常见的SQL写法就是把文本框内容拼进SQL字符串这是所有增删改查项目都应该第一时间改掉的坏习惯。比如string sql SELECT * FROM Users WHERE Name txtName.Text 表面上看能跑通问题是用户输入 OR 11拼出来就变成了SELECT * FROM Users WHERE Name OR 11整张表都被拉出来。哪怕你做个内部小工具也挡不住测试同事手滑输入一个把整段SQL弄崩。SQL注入的历史教训太多参数化查询是唯一绕不开的护城河它把变量值和SQL语句彻底分离数据库驱动负责处理输入内容的转义用户输入里再有引号也只会被当成普通字符串值。这个替换不是难事把我们上面的SqlParameter(name, value)统一替换掉字符串拼接即可。在SqlHelper里我们已经支持了params数组所以业务层改动量极小。不要因为这是内网系统不会有人攻击就不改数据库安全的标准是任何外部输入都不能直接进入SQL文本。我在一个设备管理项目里接手老代码时表里躺着一条Name为; DROP TABLE--的脏记录源头就是当年拼接SQL导致测试数据没被阻止折损了不少工时。4.2 LIKE查询与IN列表的参数化和你想的不一样有两个地方初学者总喜欢用拼接模糊查询和in操作。模糊查询容易写错成LIKE keyword%这里要对参数值本身做处理把通配符合进值里。in列表的问题更隐蔽WHERE Id IN (1,2,3)没法直接用一个字符串参数替代SQL Server不会帮你把逗号拆开传一个1,2,3进去会被当成一个值报转换错误。最常见的做法是两条路一是循环拼接问号占位符生成p0,p1,p2逐个传参二是用表值参数但这要求先建自定义表类型老库通常没这个权限。我倾向于用循环占位符方案因为兼容性好且参数数量最多几十个性能不受影响。public DataTable QueryByIds(Listint ids) { if (ids.Count 0) return new DataTable(); Liststring placeholders new Liststring(); var parameters new SqlParameter[ids.Count]; for (int i 0; i ids.Count; i) { placeholders.Add($p{i}); parameters[i] new SqlParameter($p{i}, ids[i]); } string sql $SELECT * FROM Products WHERE Id IN ({string.Join(,, placeholders)}); return SqlHelper.Query(sql, parameters); }这里把p0、p1这些占位符拼进IN括号里每个值都有独立参数既不破坏参数化约束又不会受输入内容影响。注意在WPF环境里写这种动态SQL不要怕拼接你拼的只是占位符的名字不拼用户输入这是安全动态SQL的正确形态。4.3 增删改也要参数化把Execute方法的边界说清楚增删改的参数化其实和查询一样但有一个额外的坑临时表使用和参数方向。当SQL命令包含output参数或返回值时SqlParameter要额外设置Direction ParameterDirection.Output再在Execute后读值。如果你只是做Insert、Update、Delete不需要这个特性。还有的同事喜欢把所有增删改都封装成ExecuteScalar用来拿自增ID这个做法不推荐因为ExecuteScalar只返回第一行的第一列还要配合SCOPE_IDENTITY()才能拿到刚插入的主键否则并发时容易取错。边界情况建议把插入和取ID合并到一个事务里下面这种写法就是一个标准参考。using (var conn new SqlConnection(SqlHelper.ConnStr)) { conn.Open(); var tran conn.BeginTransaction(); using (var cmd new SqlCommand(INSERT INTO Products(Name,Price) VALUES(name,price); SELECT SCOPE_IDENTITY();, conn, tran)) { cmd.Parameters.AddWithValue(name, name); cmd.Parameters.AddWithValue(price, price); int newId Convert.ToInt32(cmd.ExecuteScalar()); // 后续对子表的操作也挂在这同一个tran下 tran.Commit(); } }在WPF里处理事务务必小心事务和连接绑定不能跨线程UI线程里执行的话要把大数据量的SQL拆分避免长时间占用连接。BeginTransaction之后必须保证每条命令都传同一个事务对象漏传一条就会报ExecuteNonQuery requires the command to have a transaction when the connection is in a pending local transaction。项目里如果有多条写操作需要整体成功或整体失败一定要用这段结构。注意用AddWithValue时如果传入null会变成DBNull容易引发类型转换错误对于可空字段还是显式传DBNull.Value更可靠。5. 避坑排查WPF连接SQL数据库的5个典型翻车点5.1 连接字符串没写TrustServerCertificate导致的登录失败现象程序在同事电脑上正常在自己电脑上一直报A connection was successfully established with the server, but then an error occurred during the login process。原因SQL Server 2019之后的驱动默认启用严格加密本机测试没有正确配置证书驱动在TLS握手阶段主动拒绝。解决在连接字符串上加TrustServerCertificatetrue或去掉Encrypt参数。这个问题隐蔽性极强我在一个客户现场排查了一个下午最后发现是客户DBA给测试库开了强制加密。老项目里连接字符串是粘贴复制的极易漏掉这个参数。加之前要确认能接受明文网络传输内网环境一般没问题。5.2 DataGrid数据不刷新更新数据库后界面纹丝不动现象点击新增后数据库里有记录但DataGrid依然显示旧数据只有重启程序才能看到。原因WPF数据绑定是单向的DataTable改变后不会自动通知控件更糟糕的情况是直接把DataTable赋值给ItemsSource后又修改了DataTable.Rows[0][Name]界面不会更新。解决不要在旧DataTable上原地修改用SqlHelper重新查询获得新DataTable重新赋值给gridData.ItemsSource。如果你确实要就地更新需要调用gridData.Items.Refresh()但增删改场景下重新查询最稳妥因为界面上还要显示数据库里的默认值和计算列自己手改容易漏。5.3 中文字段变成乱码或显示成问号现象从SQL Server读出的中文全部变成???或者是写入数据库后再查出来是乱码。原因SQL Server的nvarchar/nchar类型才能正常存储中文varchar类型在客户端编码不匹配时会截断或乱码。另一个常见情况是写入时SQL里写的是VALUES(中文)而不是VALUES(N中文)导致存储端把Unicode转码成乱码。解决表字段优先使用nvarchar参数化查询传中文时SqlParameter默认按Unicode处理不需要额外处理。如果接手了老库的varchar字段写入时在SQL文本里给字符串字面量加N前缀比如WHERE Name N张三才能在老排序规则下正确匹配。在WPF里读取乱码还有一个源头是DataGrid列的绑定没设对确认Binding路径和列名完全一致双引号不要写岔。5.4 数据库操作卡住UI界面假死好几秒现象点查询按钮后界面转圈无法拖拽窗口遇到大数据量时卡十几秒。原因WPF的UI线程执行了耗时数据库操作SqlHelper.Query里的adapter.Fill(dt)是一个同步阻塞调用期间UI线程无法处理消息。解决把查询挪到async/await里用Task.Run包住数据访问或使用SqlCommand的异步方法。最简单的改法是给事件处理器加async关键字然后调用var dt await Task.Run(() SqlHelper.Query(sql, p));再赋值给DataGrid。这条改动对老项目侵入最小我通常先改查询按钮让界面在等待时能正常缩放和拖拽体验立刻好一大截。注意Async方法里如果涉及访问UI控件要在赋值那一步回到UI线程幸好WPF的await默认会保持同步上下文不会让你手动Dispatcher.Invoke。5.5 SQL Server日志暴涨或写入缓慢先查事务和索引现象程序运行两三个月后数据库文件体积翻了好几倍写入明显变慢。原因增删改操作一直跑在没提交的事务里SQL Server的日志文件不停累积或者表缺少索引导致每次Update都要全表扫描。这个现象最容易在WPF内网工具里暴露因为客户端数量少数据量不大时感觉不到等数据量变大就集中爆发。解决第一检查数据库日志文件大小日志满了就会报The transaction log for database xx is full这个报错的热搜词就是SQL Server最常见的故障之一第二确保更新和删除语句的WHERE条件覆盖的列有索引比如主键Id必须有聚集索引第三增删改的批次不要开太长事务业务做完立刻Commit。我自己经历过一次因为忘记提交事务把日志撑满的事故后来给SqlHelper增加了ExecuteInTransaction统一入口情况就再没出现过。6. 进阶从Code-Behind改到MVVM数据绑定的最小改造WPF做增删改查完全靠按钮事件也能干活但界面逻辑一多查询条件、分页、选中项状态、权限控制搅在一起代码就成了一团乱麻。这时候就该把路子往WPF MVVM方向带。MVVM听起来高大上最小改造其实可以分两步走第一步先把DataGrid绑定的数据源换成ObservableCollectionT第二步把Click事件改成ICommand。先看第一步数据源升级后集合增删会自动通知界面不用每次手动Refresh。public class ProductViewModel : INotifyPropertyChanged { public ObservableCollectionProduct Products { get; set; } new ObservableCollectionProduct(); public void Load() { Products.Clear(); DataTable dt SqlHelper.Query(SELECT Id, Name, Price, Stock FROM Products); foreach (DataRow row in dt.Rows) { Products.Add(new Product { Id (int)row[Id], Name row[Name].ToString(), Price (decimal)row[Price] }); } } public event PropertyChangedEventHandler PropertyChanged; protected virtual void OnPropertyChanged(string name) PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(name)); }把窗口的DataContext设成这个ViewModel然后界面里ItemsSource{Binding Products}。第二步再把Click事件改造成一个简单的DeleteCommand本质是事件到命令的映射。这套改动对老项目最大的好处是表格的增删改查逻辑能脱离窗口独立测试数据库操作也能拆成独立的单元测试。如果你是从头写一个WPF项目建议数据库访问层和ViewModel从一开始就分开别让窗口既管界面又管数据。我在一个MES客户端维护项目里做过一次这样的重构界面和逻辑解除耦合后后续增加权限控制只在ViewModel里加判断窗口文件一行都不用动。这套改造的陷阱是ObservableCollection默认在UI线程更新如果后台线程改集合会抛Cross-thread operation not valid。配合第5章的异步查询要用Dispatcher.Invoke把数据塞回集合。另一个值得留意的点是DataGrid的SelectedItem在MVVM下要绑定到ViewModel.SelectedProduct删除命令才能拿到当前行数据这个绑定关系建好之后整个界面的操作闭环才算完整。我自己的习惯是永远把SelectedProduct属性写在ViewModel里并且加Null判断避免数据源清空后命令崩溃。这套改下来SQL操作还是那套SqlHelper但项目结构已经可以向上生长了。希望帮到你。本文还有配套的精品资源点击获取