如何让Azure构建流水线生成的.Net 3.5 DLL包含版本元信息？

核心原因 #

流水线使用的新版MSBuild默认采用更高版本的.NET Framework工具链编译，导致mscorlib引用和.NET 3.5版本元信息未正确注入到生成的DLL中。

具体解决方案 #

1. 显式配置项目文件的目标框架与工具链 #

在项目的.csproj或.vbproj文件中添加/修改以下配置，强制指定使用.NET 3.5的工具链和目标版本：

<PropertyGroup>
  <TargetFrameworkVersion>v3.5</TargetFrameworkVersion>
  <ToolsVersion>3.5</ToolsVersion>
  <UseMSBuildEngine>3.5</UseMSBuildEngine>
</PropertyGroup>

同时确保mscorlib引用为3.5对应版本：

<Reference Include="mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089, processorArchitecture=MSIL" />

2. 在Azure流水线中指定MSBuild版本 #

在流水线的MSBuild任务里，显式调用.NET 3.5对应的MSBuild工具。如果使用Azure DevOps任务，可在配置中设置MSBuildVersion为3.5，或直接执行命令：

"C:\Windows\Microsoft.NET\Framework\v3.5\MSBuild.exe" YourProject.csproj /p:Configuration=Release

3. 确保构建代理安装.NET Framework 3.5 SDK #

即使是最新Windows版本，也可通过启用Windows功能安装.NET Framework 3.5（包含SDK）。在流水线初始化步骤添加PowerShell脚本自动安装：

Enable-WindowsOptionalFeature -Online -FeatureName NetFx3 -All

注意：该操作需要管理员权限，需确保构建代理具备执行权限。

4. 禁用自动引用解析 #

在项目文件中关闭MSBuild的自动引用解析，强制使用手动指定的mscorlib版本：

<PropertyGroup>
  <AutoGenerateBindingRedirects>false</AutoGenerateBindingRedirects>
  <DisableAutoBindingRedirects>true</DisableAutoBindingRedirects>
</PropertyGroup>

验证方法 #

构建完成后，用dotPeek重新检查DLL元信息，确认Target Framework显示为.NET Framework 3.5，且mscorlib引用版本为2.0.0.0（.NET 3.5对应的mscorlib版本）。

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