简介这份资源面向C# Winform与SQL Server数据库开发的初学者提供一套可直接运行的增删改查示例工程帮助理解网络连接与本地连接两种数据库访问方式。压缩包共28个文件约168KB包含6个cs源码文件、1个sql脚本、2个resx资源文件、2个exe可执行程序以及sln解决方案与csproj项目文件等覆盖从项目结构到数据库脚本的完整内容。资源中附带了数据库查询语句与连接配置说明读者可据此掌握连接字符串写法、ADO.NET中SqlCommand与DataReader/DataSet的配合使用以及INSERT、DELETE、UPDATE、SELECT四类操作的实现思路同时涉及app.config配置、异常处理与事务管理等常见要点。目前已有2675人学习下载适合刚接触Winform桌面开发、希望快速跑通数据库交互流程的新手参考实践。1. 从一次“连不上”的翻车说起这套环境到底装什么第一次在 C# Winform 里连 SQL Server我卡了整整一个下午。现象很朴素程序编译通过点下“查询”按钮界面直接弹出一个红叉提示“在与 SQL Server 建立连接时出现与网络相关的或特定于实例的错误”。当时我以为是代码写错了把连接字符串改了十几遍最后才发现是 SQL Server 的 TCP/IP 协议没启用实例名也没对上。这套环境——C# Winform SQL Server 的增删改查——几乎是每个 .NET 桌面开发新手都要走一遍的路装好了就是最顺手的本地数据管理工具装不好就是连不上、查不出、改不动的玄学现场。这篇笔记按“装什么版本、怎么配连接、怎么跑通增删改查、坏了怎么救”的顺序写适合刚接触 Winform 数据库编程、或者本地能跑但一换机器就翻车的开发者。2. 环境准备SQL Server 版本选择与 Winform 项目搭建2.1 SQL Server 装哪个版本别一上来就追新SQL Server 的版本选择直接决定你后面连接字符串怎么写、要不要装额外驱动。我一般会按下面这个对照来选新手别一上来就装最新的踩坑概率高。版本适用场景连接方式注意点SQL Server Express本地学习、小型项目本地实例默认实例名SQLEXPRESS免费但有 10GB 单库上限SQL Server Developer开发机、功能完整本地实例可自定义实例名功能等同企业版仅限开发用SQL Server LocalDB轻量调试、随项目走(localdb)\MSSQLLocalDB按需启动适合 Demo不适合长期服务新手最稳的选择是 SQL Server Express安装时记住实例名后面连接字符串要用。安装过程中有一个关键步骤在“实例配置”里选“默认实例”还是“命名实例”。如果你选了命名实例比如SQLEXPRESS那连接字符串里就必须写Data Source.\SQLEXPRESS少一个反斜杠都连不上。我见过太多人装完忘了实例名后面全靠猜。安装完成后打开 SQL Server 配置管理器把SQL Server (实例名)服务和SQL Server Browser服务都设为自动启动。Browser 服务很多人忽略但它负责把实例名解析成端口关掉之后用实例名连接就会失败。2.2 启用 TCP/IP 与混合验证这两步不做后面全白搭装完 SQL Server 只是第一步默认配置下它只允许本地命名管道连接Winform 用 TCP 连会直接报错。打开 SQL Server 配置管理器展开“SQL Server 网络配置”找到当前实例的协议把TCP/IP状态改为“已启用”。改完后右键 TCP/IP 属性在“IP 地址”选项卡里拉到最下面把IPAll的 TCP 端口设为1433这是 SQL Server 的默认端口设好之后连接字符串可以省略端口号。接着改身份验证模式。默认是“仅 Windows 身份验证”这意味着你的 Winform 程序如果不用当前 Windows 账户登录就会被拒。右键数据库实例选“属性”在“安全性”里把服务器身份验证改为“SQL Server 和 Windows 身份验证模式”然后重启服务。重启后展开“安全性”-“登录名”确认sa账户已启用并设置一个你能记住的密码。生产环境当然不建议用 sa但本地开发阶段用 sa 能省掉一堆权限排查。提示改完 TCP/IP 和身份验证模式后必须重启 SQL Server 服务否则配置不生效。重启不是可选项是必选项。2.3 建库建表先把数据落下来环境配好后打开 SQL Server Management StudioSSMS连上你的实例新建一个数据库。我一般命名为DemoDB方便后面代码里统一引用。建库语句很简单-- 创建演示数据库 CREATE DATABASE DemoDB; GO -- 切换到该数据库 USE DemoDB; GO -- 创建一张用户表包含自增主键和两个业务字段 CREATE TABLE Users ( Id INT IDENTITY(1,1) PRIMARY KEY, -- 自增主键从1开始每次加1 Name NVARCHAR(50) NOT NULL, -- 姓名不允许为空 Age INT NULL -- 年龄允许为空 ); GO这段 SQL 里IDENTITY(1,1)表示 Id 列自动生成插入时不用手动赋值。NVARCHAR而不是VARCHAR是为了支持中文姓名新手很容易在这里踩坑用VARCHAR存中文会变成问号。建完表后手动插入两条测试数据后面 Winform 里查询才有内容可看。2.4 创建 Winform 项目并引入必要的命名空间打开 Visual Studio新建项目选“Windows 窗体应用(.NET Framework)”框架版本选 4.7.2 或 4.8 都行这两个版本对 SQL Server 的兼容性最稳。项目建好后在解决方案资源管理器里右键“引用”确认System.Data已经引入这是SqlConnection、SqlCommand等类的来源。如果是 .NET Core 或 .NET 5 的 Winform 项目需要额外通过 NuGet 安装System.Data.SqlClient包这一点版本差异要注意。界面上拖几个控件一个DataGridView用来显示数据四个Button分别对应增、删、改、查再加几个TextBox用来输入姓名和年龄。控件命名建议规范一点比如btnAdd、btnDelete、btnUpdate、btnQuery、dgvUsers后面写事件处理时代码可读性会好很多。3. 连接字符串配置本地连接与网络连接的区别3.1 本地连接字符串怎么写本地连接指的是 Winform 程序和 SQL Server 在同一台机器上。这种情况下连接字符串的核心是Data Source和Initial Catalog。我一般会写成这样// 本地连接使用命名实例 SQLEXPRESSWindows 身份验证 string connStr Data Source.\SQLEXPRESS;Initial CatalogDemoDB;Integrated SecurityTrue;Data Source.\SQLEXPRESS里的点代表本机反斜杠后面跟实例名。如果你装的是默认实例直接写Data Source.或Data Source(local)就行。Integrated SecurityTrue表示用当前 Windows 账户登录不需要输用户名密码。这种写法最省事但前提是你的 Windows 账户在 SQL Server 里有登录权限。如果你用的是 SQL 验证连接字符串要改成这样// 本地连接SQL Server 身份验证指定用户名和密码 string connStr Data Source.\SQLEXPRESS;Initial CatalogDemoDB;User Idsa;Password你的密码;User Id和Password就是你在 SSMS 里启用的那个 sa 账户。密码里如果有分号或单引号记得做转义否则连接字符串会被截断报“格式不正确”的错。3.2 网络连接字符串的差异点网络连接指的是 Winform 程序访问另一台机器上的 SQL Server。这时候Data Source要写目标机器的 IP 或主机名并且要确保目标机器的 1433 端口对外开放。连接字符串大致如下// 网络连接指定目标 IP 和端口SQL 验证 string connStr Data Source192.168.1.100,1433;Initial CatalogDemoDB;User Idsa;Password你的密码;Connect Timeout30;注意Data Source里 IP 和端口之间用逗号分隔不是冒号。Connect Timeout30表示连接超时 30 秒网络环境差的时候可以适当调大但别调太大否则程序会卡死。网络连接最常见的翻车点是目标机器的防火墙没放行 1433 端口现象是连接超时而不是立刻报错。排查方法是在目标机器上临时关闭防火墙测试如果关掉就能连说明是防火墙规则问题需要添加入站规则放行 TCP 1433。注意网络连接时SQL Server 的 TCP/IP 协议必须在目标机器上启用并且 SQL Server Browser 服务要运行否则实例名无法解析。3.3 把连接字符串放到配置文件里硬编码连接字符串在代码里是新手常犯的错一旦换机器就要重新编译。正确做法是放到App.config里!-- App.config 中配置连接字符串 -- configuration connectionStrings add nameDemoDB connectionStringData Source.\SQLEXPRESS;Initial CatalogDemoDB;Integrated SecurityTrue providerNameSystem.Data.SqlClient / /connectionStrings /configuration然后在代码里用ConfigurationManager.ConnectionStrings[DemoDB].ConnectionString读取。这样换环境只需要改配置文件不用动代码。需要引入System.Configuration引用否则ConfigurationManager找不到。4. 增删改查落地从 SqlConnection 到 DataGridView4.1 查询把数据读进 DataTable 再绑定查询是增删改查里最基础的一步。我一般用SqlDataAdapter配合DataTable这样不用手动遍历DataReader代码更短。// 查询所有用户并绑定到 DataGridView private void btnQuery_Click(object sender, EventArgs e) { string connStr ConfigurationManager.ConnectionStrings[DemoDB].ConnectionString; using (SqlConnection conn new SqlConnection(connStr)) { try { conn.Open(); // 打开连接 string sql SELECT Id, Name, Age FROM Users; SqlDataAdapter adapter new SqlDataAdapter(sql, conn); DataTable dt new DataTable(); adapter.Fill(dt); // 把查询结果填充到 DataTable dgvUsers.DataSource dt; // 绑定到表格控件 } catch (Exception ex) { MessageBox.Show(查询失败 ex.Message); } } }using语句确保连接用完自动关闭不用手动调Close()。SqlDataAdapter.Fill会自动打开和关闭连接但显式Open()能让异常更早暴露。DataGridView的DataSource设为DataTable后列会自动生成如果想自定义列名可以在DataGridView属性里手动编辑列。4.2 新增参数化插入防止注入新增数据时千万不要用字符串拼接 SQL否则姓名里带个单引号就会报错甚至被注入。正确做法是参数化// 新增用户使用参数化查询 private void btnAdd_Click(object sender, EventArgs e) { string connStr ConfigurationManager.ConnectionStrings[DemoDB].ConnectionString; using (SqlConnection conn new SqlConnection(connStr)) { try { conn.Open(); string sql INSERT INTO Users (Name, Age) VALUES (Name, Age); SqlCommand cmd new SqlCommand(sql, conn); cmd.Parameters.AddWithValue(Name, txtName.Text.Trim()); cmd.Parameters.AddWithValue(Age, int.Parse(txtAge.Text.Trim())); int rows cmd.ExecuteNonQuery(); // 返回受影响行数 MessageBox.Show(新增成功影响行数 rows); btnQuery_Click(null, null); // 刷新表格 } catch (Exception ex) { MessageBox.Show(新增失败 ex.Message); } } }AddWithValue会自动推断参数类型但Age字段如果传空字符串会抛异常所以前面要加int.TryParse做校验。ExecuteNonQuery返回受影响行数插入成功返回 1可以用来判断是否真的写进去了。4.3 修改与删除靠主键定位修改和删除都必须基于主键否则会误伤其他行。界面上选中DataGridView某一行后取出Id再执行更新或删除。// 修改选中行的用户信息 private void btnUpdate_Click(object sender, EventArgs e) { if (dgvUsers.CurrentRow null) return; int id Convert.ToInt32(dgvUsers.CurrentRow.Cells[Id].Value); string connStr ConfigurationManager.ConnectionStrings[DemoDB].ConnectionString; using (SqlConnection conn new SqlConnection(connStr)) { conn.Open(); string sql UPDATE Users SET NameName, AgeAge WHERE IdId; SqlCommand cmd new SqlCommand(sql, conn); cmd.Parameters.AddWithValue(Name, txtName.Text.Trim()); cmd.Parameters.AddWithValue(Age, int.Parse(txtAge.Text.Trim())); cmd.Parameters.AddWithValue(Id, id); cmd.ExecuteNonQuery(); btnQuery_Click(null, null); } }删除同理把 SQL 换成DELETE FROM Users WHERE IdId即可。dgvUsers.CurrentRow.Cells[Id].Value取的是当前选中行的 Id 列值前提是查询时把 Id 列查出来了。如果DataGridView隐藏了 Id 列仍然可以通过Cells[Id].Value访问只要列存在。4.4 用 SqlCommand 还是 SqlDataAdapter怎么选简单说查询用SqlDataAdapter填DataTable增删改用SqlCommand加ExecuteNonQuery。SqlCommand也能查用ExecuteReader返回SqlDataReader但DataReader是只进只读的绑定到DataGridView不如DataTable方便。新手不用纠结按这个分工来就行。5. 避坑与排查连接失败、查询报错的常见原因5.1 报“网络相关或特定于实例的错误”现象程序一打开连接就弹这个错连不上数据库。 原因通常是 TCP/IP 协议没启用或者实例名写错或者 SQL Server Browser 服务没启动。 解决打开 SQL Server 配置管理器确认 TCP/IP 已启用、IPAll 端口为 1433、Browser 服务正在运行。然后用telnet 127.0.0.1 1433测试端口是否通不通就说明服务或防火墙有问题。5.2 报“用户登录失败”现象连接字符串里用户名密码都对但就是登录失败。 原因SQL Server 身份验证模式没改成混合模式或者 sa 账户被禁用。 解决回到 SSMS右键实例属性安全性里确认是“SQL Server 和 Windows 身份验证模式”然后检查 sa 登录名状态是否为“已启用”。改完记得重启服务。5.3 中文姓名存进去变成问号现象插入“张三”查询出来是“???”。 原因数据库字段用了VARCHAR而不是NVARCHAR或者连接字符串没指定字符集。 解决把字段类型改成NVARCHAR连接字符串里可以加Character SetUTF-8但 SQL Server 主要靠NVARCHAR解决中文问题。5.4 程序换台机器就报“找不到实例”现象开发机上跑得好好的拷到另一台机器就连不上。 原因连接字符串里写的是开发机的实例名目标机器实例名不同。 解决把连接字符串放到App.config换机器只改配置文件。同时确认目标机器已安装 SQL Server 并启用了 TCP/IP。5.5 DataGridView 不刷新现象新增或修改后表格里还是旧数据。 原因没有重新执行查询DataTable还是旧的。 解决在增删改成功后调用一次查询方法重新Fill一次DataTable再绑定。我一般把查询逻辑抽成一个独立方法增删改后直接调它。6. 装完怎么验证三条查询语句跑通就算成环境装没装好不用猜跑三条 SQL 就能验证。第一条验证连接和库是否存在-- 验证数据库可访问 SELECT DB_ID(DemoDB) AS DBID;返回非 NULL 就说明库在。第二条验证表结构和数据-- 验证表可查询 SELECT COUNT(*) AS UserCount FROM Users;能返回行数就说明表可读。第三条验证写入权限-- 验证插入权限插入后立即删除不影响数据 INSERT INTO Users (Name, Age) VALUES (N测试用户, 99); DELETE FROM Users WHERE Name N测试用户;三条都通过说明 SQL Server 端的配置没问题。然后回到 Winform点一遍查询、新增、修改、删除观察DataGridView是否同步变化。如果查询有数据、新增后表格多一行、修改后表格内容变了、删除后表格少一行这套环境就算跑通了。我自己的习惯是每次换机器或者重装 SQL Server 后先把这三条 SQL 在 SSMS 里跑一遍再开 Winform 点一遍。这个习惯帮我省掉了很多“以为是代码问题、其实是环境问题”的排查时间。从那以后我每次配完连接字符串都强制走一遍这三条验证不跳过。希望帮到你。本文还有配套的精品资源点击获取