C#连接SQL Server数据库的实用操作指南

在开发桌面应用或后台服务时，经常需要把ref="/tag/426/" style="color:#3D6345;font-weight:bold;">数据存进数据库。比如你正在做一个小型仓库管理系统，用户录入的商品信息得保存下来，下次打开还能查得到。这时候用 C# 配合 SQL Server 就是个很常见的选择。只要几行代码，就能让程序和数据库“通上话”。

确认环境准备就绪

开始前先看看你的电脑有没有装好 Visual Studio，建议用 2019 或更新版本。SQL Server 可以用本地安装的实例，也可以用 SQL Server Express LocalDB，后者轻量又不用单独配置服务。如果还没装，去官网下载安装包，一步步按提示走就行，安装过程选默认设置基本就够用了。

添加数据库连接引用

C# 中操作 SQL Server 主要用的是 System.Data.SqlClient 命名空间。新建一个控制台项目后，在代码顶部加上这句：

using System.Data.SqlClient;

如果是 .NET Core 或 .NET 5+ 项目，可能需要通过 NuGet 安装 Microsoft.Data.SqlClient 包。在解决方案资源管理器里右键“依赖项”，选“管理 NuGet 程序包”，搜索这个包并安装即可。

写一段能跑通的连接代码

假设你的数据库服务器是本地的，数据库名叫 WarehouseDB，里面有个表叫 Products。下面这段代码可以测试是否连得上：

string connectionString = "Server=localhost;Database=WarehouseDB;Integrated Security=true;";

using (SqlConnection conn = new SqlConnection(connectionString))
{
    try
    {
        conn.Open();
        Console.WriteLine("成功连接到数据库！");

        string sql = "SELECT COUNT(*) FROM Products";
        using (SqlCommand cmd = new SqlCommand(sql, conn))
        {
            int count = (int)cmd.ExecuteScalar();
            Console.WriteLine($"Products 表中有 {count} 条记录");
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine("连接失败：" + ex.Message);
    }
}

这里的连接字符串可以根据实际情况调整。如果你用的是 SQL 账号密码登录，可以把 Integrated Security=true 换成 User ID=用户名;Password=密码;。

常见问题怎么处理

有时候写着写着运行报错“无法连接到服务器”，先别急着重装软件。有几个地方可以快速检查一下：SQL Server 服务有没有启动？可以在 Windows 的“服务”里找 SQL Server (MSSQLSERVER) 是否正在运行；防火墙有没有拦住？特别是远程连接的时候；还有就是连接字符串里的服务器名称对不对，有些人把 localhost 写成 local 或者 .\SQLEXPRESS 却没装对应实例。

还有一个小技巧：在 Visual Studio 的“服务器资源管理器”里手动添加一个数据连接，连通后再右键属性复制连接字符串，这样不容易出错。

把连接逻辑封装起来更方便

实际项目中不会每次都写一遍 open 和 try-catch。可以把连接部分封装成一个方法，比如：

public static SqlConnection GetConnection()
{
    string connStr = "Server=localhost;Database=WarehouseDB;Integrated Security=true;";
    return new SqlConnection(connStr);
}

然后在需要用的地方调用它，代码看起来更清爽，改数据库地址也只改这一处就行。