Microsoft.Data.SqlClient与System.Data.SqlClient编译输出差异及分发疑问

代码示例 #

引用System.Data.SqlClient的代码 #

using System.Data.SqlClient;

namespace ConsoleApp2
{
    internal class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Hello, World!");
            var c = new SqlConnection();
        }
    }
}

编译后生成的文件如图：

引用Microsoft.Data.SqlClient的代码 #

using Microsoft.Data.SqlClient;

namespace ConsoleApp2
{
    internal class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Hello, World!");
            var c = new SqlConnection();
        }
    }
}

编译后生成的文件如图：

问题解答 #

1. 是否必须随应用分发所有生成的文件？ #

对，绝大多数生成的文件都是必须跟着应用一起分发的。Microsoft.Data.SqlClient拆分出多个文件是为了实现按需加载和平台特定优化——不同文件对应不同的功能模块（比如加密、SNI、平台适配逻辑），缺了任何一个依赖文件，应用大概率会在运行时抛出FileNotFoundException，或者直接出现功能异常。你自己删除文件后发现多数为必需，这也能说明这些拆分的文件并非冗余，是库设计时就拆分好的核心依赖。

2. 能否限制Microsoft.Data.SqlClient生成的文件数量？其他数据库库（如Firebird、Odbc）仅生成单个XXX.Data.XClient.dll。 #

可以通过几种方式减少发布文件数量，但没法完全做到像其他库那样只保留单个DLL：

• 使用早期版本的Microsoft.Data.SqlClient：比如4.0之前的版本拆分的文件较少，但这类版本已停止维护，存在安全风险，不推荐使用。
• 启用裁剪（Trimming）：在项目文件中设置<PublishTrimmed>true</PublishTrimmed>，可以移除应用未用到的库代码和依赖文件。但要注意，裁剪可能误删反射调用的代码，需要手动配置TrimmerRootAssembly或TrimmerDescriptor来保证核心功能正常。
• 采用框架依赖发布：如果目标环境已安装对应的.NET运行时，选择框架依赖发布而非独立发布，可减少需要分发的文件（无需携带运行时相关文件）。
• 排除特定平台文件：如果你的应用仅针对单一平台（比如Windows x64），可以在项目文件中显式排除其他平台的适配文件。例如：

  <ItemGroup>
    <PackageReference Include="Microsoft.Data.SqlClient" Version="5.1.5" />
    <ExcludeAssets Include="runtime; build; native; contentfiles; analyzers" />
  </ItemGroup>
  

  但此操作需谨慎，要确保不会影响当前平台的功能。

Microsoft.Data.SqlClient的多文件设计是为了适配跨平台需求和模块化功能，和Firebird、Odbc这类仅专注单一场景的库设计思路不同，因此无法完全做到单文件分发，除非使用你提到的单文件发布（但你因体积过大排除了这个选项）。

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