<p>Visual Studio 配置 C# 数据库项目需明确三件事：使用 Microsoft.Data.SqlClient 驱动（.NET Core 3.0+ 必选）、构造正确连接字符串（本地用 Trusted_Connection，Azure 必须用户名密码+Encrypt=True）、确保目标框架与驱动版本及平台架构兼容。</p>
Visual Studio 配置 C# 数据库项目，核心不是“装完就能用”，而是要分清三件事：用什么驱动连数据库、连接字符串怎么写才不报错、以及项目本身是否带对了运行时依赖。漏掉任一环，SqlException 或 InvalidOperationException 就会立刻出现。
确认并安装 Microsoft.Data.SqlClient 驱动
从 .NET Core 3.0 开始，System.Data.SqlClient 已被标记为过时，新项目必须用 Microsoft.Data.SqlClient。VS 默认不带它，必须手动加 NuGet 包。
- 右键项目 → “管理 NuGet 包” → 切换到“浏览”标签页
- 搜索
Microsoft.Data.SqlClient，选最新稳定版（如5.2.2），点“安装” - 安装后检查
.csproj文件里是否新增了类似这行：<PackageReference Include="Microsoft.Data.SqlClient" Version="5.2.2" />
- 如果项目是 .NET Framework 4.7.2+，也能用这个包；但若低于 4.6.1，得降级到
Microsoft.Data.SqlClient2.x 或改用旧驱动（不推荐）
构造正确的 SQL Server 连接字符串
连接字符串写错是 SqlException: A network-related or instance-specific error... 的最常见原因。本地 SQL Server 和 Azure SQL 的格式差异很大，不能混用。
- 本地 SQL Server（默认实例）示例：
"Server=localhost\SQLEXPRESS;Database=testdb;Trusted_Connection=true;"
- Azure SQL 示例：
"Server=tcp:yourserver.database.windows.net,1433;Initial Catalog=yourdb;Persist Security Info=False;User ID=youruser;Password=yourpass;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;"
- 关键区别：
Trusted_Connection=true只适用于 Windows 身份验证（本地常用），Azure 必须用用户名/密码 +Encrypt=True - 别把
localhost直接换成 Azure 地址还留着Trusted_Connection—— 这会卡在认证环节，错误信息却只显示“登录失败”
检查目标框架与部署环境兼容性
项目能编译通过，不代表能在目标机器上跑数据库操作。.NET 版本和 SQL 驱动的组合有隐性约束。
- 如果你选的是
.NET 8.0或.NET 9.0，Microsoft.Data.SqlClient5.x 完全支持 - 但若项目目标是
.NET Framework 4.8，某些新版驱动（如 6.0+）会拒绝安装，VS 提示“不兼容” - 发布为独立部署（self-contained）时，
Microsoft.Data.SqlClient会自动打包 native dll（如sni.dll），但 x64/x86 架构必须和 SQL Server 实例匹配；32 位程序连不上 64 位 SQL Server 的命名管道 - 调试时若看到
DllNotFoundException: sni.dll，八成是平台目标（x86/x64/AnyCPU）设错了 —— 在项目属性 → “生成”选项卡里确认“目标平台”
最容易被忽略的其实是连接字符串里的空格和分号：多一个空格、少一个分号、或者用了中文标点，都会让 SqlConnection 解析失败，抛出看似无关的 ArgumentException。建议把连接字符串存在 appsettings.json 里，用 IConfiguration.GetConnectionString() 读取，而不是硬编码在 new SqlConnection(...) 里。
