VS2019打开.dbml文件提示不支持Microsoft.Data.SqlClient的原因与解决办法

问题原因 #

• VS2019自带的Linq to SQL设计器仅默认支持System.Data.SqlClient，项目升级到.NET Framework 4.8后，若通过NuGet更新或配置修改将数据源驱动切换为Microsoft.Data.SqlClient，旧版设计器无法识别这个新的SQL客户端库。
• VS2022的Linq to SQL设计器经过更新，已原生支持Microsoft.Data.SqlClient，因此可以正常打开.dbml文件。
• 编译调试无异常是因为项目运行时兼容两种SQL客户端库，设计器的识别问题不影响代码执行。

解决方法 #

1. 回滚.dbml的数据源配置 #

右键.dbml文件选择「打开方式→XML编辑器」，找到<Connection>节点的Provider属性，将Microsoft.Data.SqlClient替换为System.Data.SqlClient：

<Connection Mode="AppSettings" ConnectionString="你的连接字符串" Provider="System.Data.SqlClient" />

保存后重新用VS2019打开.dbml，设计器即可正常加载。

2. 更新VS2019组件 #

打开VS2019安装程序，检查并安装最新的：

• .NET Framework开发工具更新包
• SQL Server数据工具（SSDT）更新
  微软后期为VS2019推送的补丁中添加了对Microsoft.Data.SqlClient的有限支持，更新后可能解决设计器识别问题。

3. 保留System.Data.SqlClient引用 #

在项目的NuGet包管理器中，确保同时安装System.Data.SqlClient和Microsoft.Data.SqlClient。这样VS2019设计器可调用旧驱动加载.dbml，项目运行时仍能使用新驱动（若代码中指定）。

4. 配置项目强制设计器使用旧驱动 #

编辑项目文件（*.csproj），添加以下配置节点：

<PropertyGroup>
  <LinqToSqlProvider>System.Data.SqlClient</LinqToSqlProvider>
</PropertyGroup>

保存后重新加载项目，VS2019即可正常打开.dbml。VS2022无需修改此配置，可兼容两种驱动设置。

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