在C#开发涉及SQL Server数据库的应用程序时，连接字符串是建立数据库连接的核心配置，手动拼接字符串不仅容易遗漏参数、写错语法，在需要动态调整服务器地址、数据库名称、认证方式等参数时也会带来较高的维护成本。SqlConnectionStringBuilder是.NET框架中System.Data.SqlClient命名空间下提供的专用工具类，专门用于安全、便捷地构建SQL Server连接字符串，它内置了所有标准连接参数的属性，通过属性赋值的方式就能生成格式正确的连接字符串，避免了很多手动拼接的潜在问题。
SqlConnectionStringBuilder基础用法
使用SqlConnectionStringBuilder首先需要引入对应的命名空间，然后创建该类的实例，通过给实例的公共属性赋值来设置连接参数，最后通过ConnectionString属性获取最终生成的连接字符串。
常用连接属性说明
SqlConnectionStringBuilder提供了大量与SQL Server连接相关的属性，以下是开发中最常用的几个：
- DataSource：设置数据库服务器地址，可以是IP地址、服务器名称或者实例名
- InitialCatalog：设置要连接的数据库名称
- UserID：设置SQL Server登录用户名，使用SQL Server认证时需要设置
- Password：设置SQL Server登录密码，使用SQL Server认证时需要设置
- IntegratedSecurity：设置是否使用Windows集成认证，值为true时使用当前Windows用户身份登录，无需设置UserID和Password
- ConnectTimeout：设置连接超时时间，单位为秒，默认是15秒
生成基础连接字符串示例
以下代码演示了使用SqlConnectionStringBuilder生成SQL Server认证方式的连接字符串：
using System;
using System.Data.SqlClient;
namespace ConnectionStringBuilderDemo
{
class Program
{
static void Main(string[] args)
{
// 创建SqlConnectionStringBuilder实例
SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder();
// 设置服务器地址
builder.DataSource = "127.0.0.1";
// 设置数据库名称
builder.InitialCatalog = "TestDB";
// 设置SQL Server认证用户名
builder.UserID = "sa";
// 设置SQL Server认证密码
builder.Password = "123456";
// 设置连接超时时间为30秒
builder.ConnectTimeout = 30;
// 获取生成的连接字符串
string connectionString = builder.ConnectionString;
Console.WriteLine("生成的连接字符串：");
Console.WriteLine(connectionString);
}
}
}
上述代码运行后会输出类似如下的连接字符串：Data Source=127.0.0.1;Initial Catalog=TestDB;User ID=sa;Password=123456;Connect Timeout=30，格式完全符合SQL Server连接字符串的标准规范。
动态修改连接参数
SqlConnectionStringBuilder的优势在于可以动态修改连接参数，不需要重新拼接整个字符串。比如在多环境部署时，只需要修改对应的属性值就能生成不同环境的连接字符串。
以下示例演示了如何基于已有连接字符串动态修改参数：
using System;
using System.Data.SqlClient;
namespace ConnectionStringBuilderDemo
{
class Program
{
static void Main(string[] args)
{
// 基于已有连接字符串初始化SqlConnectionStringBuilder
string baseConnStr = "Data Source=127.0.0.1;Initial Catalog=TestDB;Integrated Security=True";
SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder(baseConnStr);
// 动态修改数据库名称为ProdDB
builder.InitialCatalog = "ProdDB";
// 动态修改服务器地址为192.168.0.1
builder.DataSource = "192.168.0.1";
// 关闭集成认证，切换为SQL Server认证
builder.IntegratedSecurity = false;
builder.UserID = "prod_user";
builder.Password = "prod_password";
string newConnStr = builder.ConnectionString;
Console.WriteLine("修改后的连接字符串：");
Console.WriteLine(newConnStr);
}
}
}
结合SqlConnection使用连接字符串
生成连接字符串的最终目的是用于建立数据库连接，通常我们会将生成的连接字符串传递给SqlConnection对象来打开数据库连接，执行后续操作。
以下示例演示了完整的数据库连接和操作流程：
using System;
using System.Data.SqlClient;
namespace ConnectionStringBuilderDemo
{
class Program
{
static void Main(string[] args)
{
try
{
// 构建连接字符串
SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder();
builder.DataSource = "127.0.0.1";
builder.InitialCatalog = "TestDB";
builder.IntegratedSecurity = true;
string connStr = builder.ConnectionString;
// 创建SqlConnection对象并打开连接
using (SqlConnection conn = new SqlConnection(connStr))
{
conn.Open();
Console.WriteLine("数据库连接成功");
// 执行简单查询
string sql = "SELECT COUNT(*) FROM sys.tables";
using (SqlCommand cmd = new SqlCommand(sql, conn))
{
int tableCount = (int)cmd.ExecuteScalar();
Console.WriteLine($"当前数据库中的表数量为：{tableCount}");
}
}
}
catch (Exception ex)
{
Console.WriteLine($"操作发生异常：{ex.Message}");
}
}
}
}
注意事项
使用SqlConnectionStringBuilder时需要注意以下几点：
- 如果设置的属性值不符合规范，比如密码中包含特殊字符，SqlConnectionStringBuilder会自动处理转义，不需要开发者手动处理
- 不要将敏感信息（如数据库密码）硬编码在代码中，建议结合配置文件或者环境变量动态读取参数再赋值给SqlConnectionStringBuilder
- SqlConnectionStringBuilder仅适用于SQL Server数据库，如果需要连接其他类型数据库，需要使用对应数据库的连接字符串构建器，比如MySqlConnectionStringBuilder用于MySQL数据库
SqlConnectionStringBuilder通过属性赋值的方式生成连接字符串，大幅降低了手动拼接的错误概率，同时提升了连接字符串的可维护性，是C#开发中处理SQL Server连接配置的最佳实践之一。
C#SqlConnectionStringBuilder数据库连接字符串SqlConnection修改时间：2026-06-30 14:30:36