.NET 6.0使用Microsoft.TeamFoundationServer.ExtendedClient时如何解决NU1701警告？

我在把Microsoft.TeamFoundationServer.ExtendedClient包添加到.NET 6.0控制台应用时，出现以下警告：

E:\tmp\test\test.csproj : warning NU1701: Package 'Microsoft.AspNet.WebApi.Core 5.2.7' was restored using '.NETFramework,Version=v4.6.1, .NETFramework,Version=v4.6.2, .NETFramework,Version=v4.7, .NETFramework,Version=v4.7.1, .NETFramework,Version=v4.7.2, .NETFramework,Version=v4.8, .NETFramework,Version=v4.8.1' instead of the project target framework 'net6.0'. This package may not be fully compatible with your project.

请问我引用的包是否正确？如何消除该警告？或者能否直接忽略它？
（此应用程序用于访问和操作TFS源代码管理项。）

复现步骤 #

在Visual Studio 2022命令提示符中执行以下命令：

dotnet new console -n test
cd test
dotnet add package Microsoft.TeamFoundationServer.ExtendedClient
dotnet build

构建后会生成上述警告。

生成的.csproj文件内容如下：

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net6.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.TeamFoundationServer.ExtendedClient" Version="16.170.0" />
  </ItemGroup>

</Project>

问题解答 #

一、引用的包是否正确？ #

针对访问TFS源代码管理项的需求，Microsoft.TeamFoundationServer.ExtendedClient是官方提供的适配包，本身选型没问题。警告的根源是这个包依赖的Microsoft.AspNet.WebApi.Core 5.2.7仅支持.NET Framework，没有适配.NET Core/.NET 6+的版本，所以触发了NU1701兼容性警告。

二、如何消除该警告？ #

有三种可行方案：

1. 单独屏蔽该依赖的警告
   在项目的ItemGroup中给依赖的WebApi包添加NoWarn属性，只屏蔽这个特定包的NU1701警告，不影响其他包的警告提示：

   <ItemGroup>
     <PackageReference Include="Microsoft.TeamFoundationServer.ExtendedClient" Version="16.170.0" />
     <PackageReference Include="Microsoft.AspNet.WebApi.Core" Version="5.2.7">
       <NoWarn>NU1701</NoWarn>
     </PackageReference>
   </ItemGroup>
   

2. 全局屏蔽NU1701警告
   如果确定所有.NET Framework兼容包都不会影响功能，可以在项目的PropertyGroup中添加全局警告抑制：

   <PropertyGroup>
     <OutputType>Exe</OutputType>
     <TargetFramework>net6.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
     <NoWarn>NU1701</NoWarn>
   </PropertyGroup>
   

3. 替换为原生兼容的包（可选）
   微软针对.NET Core/.NET 5+推出了Azure.DevOps.Core等包，用于访问Azure DevOps（包含TFS后续演进版本）的源代码管理。如果你的TFS版本支持Azure DevOps API，可以考虑迁移到这些原生支持.NET 6的包，但需要注意API差异。

三、能否直接忽略该警告？ #

可以忽略，但前提是你已经验证过应用的核心功能（TFS源代码管理的访问、操作）正常工作。因为.NET Framework的包在.NET 6下通过兼容层运行，大部分基础功能可以正常使用，但可能存在某些边缘场景（比如特定API调用、配置方式）出现异常。建议先完成功能测试，确认无问题后再忽略警告。

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