如何创建可跨系统运行的C# SQL Server应用安装包及连接字符串

一、修正连接字符串的核心错误 #

你当前的连接字符串存在格式问题，尤其是第二个实例名的写法完全错误。针对SQL Server Express本地实例，正确的标准格式如下：

<connectionStrings>
    <add name="CS" 
         connectionString="data source=.\SQLEXPRESS;initial catalog=mydbname; integrated security=true;MultipleActiveResultSets=True" 
         providerName="System.Data.SqlClient"/>
</connectionStrings>

• .代表本地机器，SQLEXPRESS是SQL Server Express的默认实例名，两者必须用**反斜杠\**分隔，而非斜杠/
• integrated security=true采用Windows身份验证，无需用户输入账号密码，完全适配无技术基础的用户场景

二、实现安装过程自动配置SQL Server Express #

要让用户零干预完成配置，需在安装包中加入以下自动操作：

1. 固定SQL Server Express实例名安装
   在Visual Studio安装项目的前置条件中，选择SQL Server 2019 Express时，指定安装参数：

/QS /IACCEPTSQLSERVERLICENSETERMS /ACTION=Install /FEATURES=SQLEngine /INSTANCENAME=SQLEXPRESS /SECURITYMODE=Windows

该参数会强制以默认实例名SQLEXPRESS安装，保证连接字符串的统一性。

2. 自动启用TCP/IP协议并配置端口
   添加安装后自定义操作，执行PowerShell脚本（需以管理员权限运行）：

# 加载SMO组件
[System.Reflection.Assembly]::LoadWithPartialName('Microsoft.SqlServer.Smo') | Out-Null
$server = New-Object Microsoft.SqlServer.Management.Smo.Server('.\SQLEXPRESS')

# 启用TCP/IP协议
$tcpProtocol = $server.ServerProtocols['Tcp']
$tcpProtocol.IsEnabled = $true
$tcpProtocol.Alter()

# 设置IPAll端口为1433
$ipAddressGroup = $tcpProtocol.IPAddresses['IPAll']
$ipAddressGroup.TcpPort = '1433'
$ipAddressGroup.Alter()

# 重启SQL Server服务使配置生效
Restart-Service 'MSSQL$SQLEXPRESS'

三、自动部署目标数据库 #

用户机器不存在mydbname数据库，需在安装时自动完成创建或附加：

1. 附加数据库文件方案
   将项目的.mdf和.ldf文件包含在安装包中，安装时复制到固定路径（如C:\Program Files\你的应用名\Data），然后执行SQL命令附加：

CREATE DATABASE mydbname ON 
(FILENAME = 'C:\Program Files\你的应用名\Data\mydbname.mdf'),
(FILENAME = 'C:\Program Files\你的应用名\Data\mydbname_log.ldf')
FOR ATTACH;

可通过sqlcmd工具执行该命令：

sqlcmd -S .\SQLEXPRESS -E -i "C:\Program Files\你的应用名\Scripts\AttachDB.sql"

2. SQL脚本创建方案
   将数据库结构和初始数据导出为SQL脚本，安装时用sqlcmd执行脚本完成数据库创建。

四、动态适配连接字符串（可选） #

为避免路径或实例名异常导致连接失败，可在应用启动时自动修正连接字符串：

using System.Configuration;
using System.Data.SqlClient;
using System.IO;

public static void EnsureValidConnectionString()
{
    var config = ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None);
    var csEntry = config.ConnectionStrings.ConnectionStrings["CS"];
    if (csEntry == null) return;

    var csBuilder = new SqlConnectionStringBuilder(csEntry.ConnectionString);
    // 强制指定本地SQLEXPRESS实例
    csBuilder.DataSource = @".\SQLEXPRESS";
    // 附加数据库时自动适配安装路径
    csBuilder.AttachDBFilename = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Data", "mydbname.mdf");
    
    csEntry.ConnectionString = csBuilder.ConnectionString;
    config.Save(ConfigurationSaveMode.Modified);
    ConfigurationManager.RefreshSection("connectionStrings");
}

在应用启动入口（如Program.cs的Main方法）调用此方法。

五、确保安装包权限 #

安装包必须以管理员身份运行，否则无法修改SQL Server配置和系统服务。在Visual Studio安装项目中：

• 将InstallAllUsers属性设为True
• 在项目属性中勾选“Require administrator privileges”

内容的提问来源于stack exchange，提问作者sadegh