MSOLEDBSQL与.NET OleDbConnection搭配时MultiSubnetFailover=Yes报错咨询

问题场景回顾 #

使用MSOLEDBSQL 18.5.0-18.6.5版本连接SQL Server可用性组时，若连接字符串指定MultiSubnetFailover=Yes并结合.NET OleDbConnection使用，会触发“初始化字符串格式不符合OLE DB规范”错误。示例连接字符串：

Provider=MSOLEDBSQL;DataTypeCompatibility=80;MultiSubnetFailover=Yes;Connect Timeout=30;Server=tcp:AvailabilityGroupListenerDnsName,port;Database=mydb;Integrated Security=SSPI;

而将参数改为MultiSubnetFailover=True则可正常连接，这一差异与.NET和OLE DB驱动的交互机制直接相关。

核心原因：两层解析逻辑的规则不匹配 #

• MSOLEDBSQL驱动本身：作为OLE DB原生驱动，它对MultiSubnetFailover参数的支持包含Yes/No和True/False两种取值，两种格式都能被驱动识别；
• .NET OleDbConnection封装层：.NET框架在解析OLE DB连接字符串时，会遵循自身的参数格式规范——对于布尔类型参数，仅接受True/False（大小写不敏感）作为合法取值，Yes/No会被判定为格式非法，直接抛出错误，不会将该参数传递到驱动层面。

文档中“初始化方式”的含义 #

微软文档提到“可根据初始化方式取True或Yes”，这里的“初始化方式”指的是连接创建的不同路径：

• 直接调用OLE DB原生API（如C++中使用OLE DB接口）时，驱动可以兼容Yes/No；
• 通过.NET OleDbConnection创建连接时，由于存在.NET层面的前置校验，仅True/False能通过校验。

解决方案 #

统一使用MultiSubnetFailover=True（或False）作为参数取值，既符合.NET的格式要求，也能被MSOLEDBSQL驱动正常识别，避免格式错误。

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