.NET Core下Microsoft.TeamFoundationServer.ExtendedClient替代方案及解决办法咨询

我帮你梳理下针对.NET Core的替代方案，毕竟Microsoft.TeamFoundationServer.ExtendedClient确实不支持.NET Core环境，微软已经有了官方的替代方案，下面是具体的解决思路：

1. 优先使用官方Azure DevOps .NET SDK #

微软已经把TFS和Azure DevOps的客户端库统一更新为Azure DevOps .NET SDK，这个库完全兼容.NET Core/.NET 5+，是官方推荐的替代方案。你需要安装这两个NuGet包：

• Microsoft.TeamFoundationServer.Client：负责TFS工作项追踪的核心功能
• Microsoft.VisualStudio.Services.Client：处理身份验证和服务器连接

快速实现示例 #

using Microsoft.VisualStudio.Services.Client;
using Microsoft.TeamFoundation.WorkItemTracking.WebApi;
using Microsoft.TeamFoundation.WorkItemTracking.WebApi.Models;

// 配置TFS服务器地址和凭据（推荐用个人访问令牌PAT）
var tfsUri = new Uri("http://your-tfs-server:8080/tfs/YourCollection");
var credentials = new VssBasicCredential(string.Empty, "your-pat-token");

// 建立连接并获取工作项客户端
using var connection = new VssConnection(tfsUri, credentials);
var workItemClient = connection.GetClient<WorkItemTrackingHttpClient>();

// 查询工作项（示例查询用户故事的标题和迭代路径）
var wiqlQuery = new Wiql
{
    Query = "SELECT [System.Id], [System.Title], [System.IterationPath] FROM WorkItems WHERE [System.WorkItemType] = 'User Story'"
};

var queryResult = await workItemClient.QueryByWiqlAsync(wiqlQuery);
foreach (var workItemRef in queryResult.WorkItems)
{
    var workItem = await workItemClient.GetWorkItemAsync(
        workItemRef.Id,
        fields: new[] { "System.Title", "System.IterationPath" }
    );
    Console.WriteLine($"ID: {workItem.Id}, 标题: {workItem.Fields["System.Title"]}, 迭代: {workItem.Fields["System.IterationPath"]}");
}

2. 备选方案：直接调用REST API #

如果SDK的封装不符合你的需求，也可以直接调用TFS的REST API，这种方式完全跨平台，灵活性更高：

• 身份验证：将个人访问令牌（PAT）格式化为":" + pat后进行Base64编码，作为Authorization请求头的Basic凭证
• 查询工作项的API端点：GET http://your-tfs-server:8080/tfs/YourCollection/YourProject/_apis/wit/wiql?api-version=6.0
• 获取单个工作项详情：GET http://your-tfs-server:8080/tfs/YourCollection/_apis/wit/workitems/{id}?fields=System.Title,System.IterationPath&api-version=6.0

关于你之前尝试的方案失效的说明 #

你提到的旧方案依赖的库可能已经被微软弃用或不再维护，所以在现代.NET环境下无法正常工作，官方的Azure DevOps SDK是目前唯一受支持的途径，建议优先迁移到这个方案。

最后Fallback方案 #

如果以上方案都无法满足你的特定需求，再考虑继续使用.NET Framework项目，但官方SDK已经覆盖了绝大多数TFS工作项的操作场景，应该可以完全替代原来的Microsoft.TeamFoundationServer.WorkItemTracking.Client功能。

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