WiX安装程序向自定义操作传递含分号的数据库连接字符串的分号转义问题

问题根源 #

这个问题是DTF自定义操作的高频踩坑点：手动拼接自定义操作参数字符串时，没有对值本身的特殊字符做转义，导致DTF解析时把数据库连接字符串里的分号误判为键值对的分隔符，出现逻辑完全错乱的反序列化错误。

核心解决方法 #

完全不需要改动你现有收集完整数据库连接串的UI逻辑，直接把手动拼接参数的写法换成DTF自带的CustomActionData对象序列化机制，所有转义逻辑会由框架自动处理，刚好适配你同时支持PostgreSQL、MS SQL，允许自定义连接参数的场景。
具体改动两步：

1. 修改即时自定义操作的托管逻辑
   把原来硬拼参数值的SetupCustomProperties自定义操作，调整为调用一个即时执行的托管方法，用CustomActionData对象自动完成所有特殊字符转义：

   [CustomAction]
   public static ActionResult PrepareDeferredActionData(Session session)
   {
       // 初始化CustomActionData对象，框架会自动处理所有特殊字符的转义
       var actionParams = new CustomActionData
       {
           ["DBTYPE"] = session["DBTYPE"],
           ["CONNECTIONSTRING"] = session["CONNECTIONSTRING"],
           ["INSTALLFOLDER"] = session["INSTALLFOLDER"]
       };
       // 将转义完成的字符串赋值给和延迟自定义操作同名的属性
       session["ServiceSetupActions"] = actionParams.ToString();
       return ActionResult.Success;
   }
   

2. 更新WiX标记中的自定义操作定义
   删掉原来直接硬拼Value的SetupCustomProperties操作定义，替换为上面这个即时方法的调用：

   <CustomAction 
     Id="SetupCustomProperties"
     Return="check"
     BinaryKey="CustomActionBinary"
     DllEntry="PrepareDeferredActionData"
     Execute="immediate" />
   

这种写法的好处是：序列化和反序列化逻辑完全由DTF框架托管，和你在延迟CA中读取session.CustomActionData的解析规则完全对称，不管连接字符串里有多少分号、等号、反斜杠，都不会出现拆分错误，也完全不用改动你现有的输入收集流程——你在延迟CA里的读取逻辑也不用调整，还是正常用session.CustomActionData["CONNECTIONSTRING"]取值，拿到的就是完整的原始连接字符串。

不推荐的手动拼接方案 #

如果你出于特殊原因必须手动拼接参数字符串，需要严格按照DTF的解析规则对每个值做转义，不能偷懒：

• 值中的反斜杠\替换为\\
• 值中的等号=替换为\=
• 值中的分号;替换为\;
  提醒：给值加引号的写法完全没用，DTF的解析逻辑只识别反斜杠转义的分隔符，不会把引号当作特殊边界处理，这种写法很容易因为漏转义再次出现解析错误，不推荐使用。

关于替代方案的说明 #

你提到的拆分收集服务器、库名、账号密码的连接对话框方案，在当前问题下完全没必要实现——上面的原生转义方案可以完美兼容你现有收集完整连接串的逻辑，不需要适配两种数据库的参数差异，也能支持用户自定义的连接参数。

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