如何用C#检查TFVC变更集是否已合并至指定分支？

没问题，我来帮你搞定这个需求！要检查变更集是否已合并到指定分支，咱们可以利用Azure DevOps .NET SDK中的TfvcHttpClient提供的分支历史查询能力，具体步骤和代码如下：

核心思路 #

Visual Studio的"Track Changesets"本质是追踪变更集在分支间的流转历史（包括合并操作）。我们可以通过GetChangesetBranchHistoryAsync方法查询目标变更集是否存在于指定分支的历史中，或是通过合并操作被带入该分支。

修正并完善你的代码 #

首先注意你现有代码中GetChangesetAsync的参数顺序有误（应该先传变更集ID，再传项目名），然后添加合并检查逻辑：

using Microsoft.TeamFoundation.SourceControl.WebApi;
using System.Linq;
using System.Threading.Tasks;

// 假设你已经获取到目标分支对象：TfvcBranch targetTfvcBranch

public async Task CheckChangesetMergeStatus(WorkItem wi)
{
    using (var changeSetClient = new TfvcHttpClient(_uri, _credentials))
    {
        foreach (var relation in wi.Relations.Where(r => r.Url.Contains("Changeset")))
        {
            // 解析变更集ID，确保格式正确
            if (!int.TryParse(relation.Attributes["id"].ToString(), out int changesetId))
            {
                // 处理无效ID的情况
                continue;
            }

            // 获取变更集详情（修正参数顺序）
            var changeset = await changeSetClient.GetChangesetAsync(
                changesetId, 
                project: "Welfare_Research_2009"
            );

            // 目标分支的完整路径（从你的targetTfvcBranch对象获取）
            string targetBranchPath = targetTfvcBranch.Path;

            // 查询该变更集在目标分支的历史记录
            var branchHistory = await changeSetClient.GetChangesetBranchHistoryAsync(
                changesetId,
                project: "Welfare_Research_2009",
                targetBranch: targetBranchPath
            );

            // 判断是否已合并：两种情况
            // 1. 变更集直接提交到目标分支
            // 2. 变更集通过合并操作被带入目标分支
            bool isMerged = branchHistory.Any(history => 
                history.Branch.Path.Equals(targetBranchPath, System.StringComparison.OrdinalIgnoreCase) ||
                history.MergeSources.Any(source => source.ChangesetId == changesetId)
            );

            // 输出结果（根据你的需求替换为业务逻辑）
            if (isMerged)
            {
                System.Console.WriteLine($"变更集 {changesetId} 已合并到分支 {targetBranchPath}");
            }
            else
            {
                System.Console.WriteLine($"变更集 {changesetId} 未合并到分支 {targetBranchPath}");
            }
        }
    }
}

关键代码解释 #

• GetChangesetBranchHistoryAsync: 这是实现追踪功能的核心方法，它会返回变更集在分支间的流转记录，包括合并来源信息。
• 合并状态判断逻辑:
  • 直接提交到目标分支的变更集，其分支历史条目会直接匹配目标分支路径。
  • 通过合并进入目标分支的变更集，MergeSources属性会包含原始变更集的ID，以此判断合并关系。
• 异步操作: 建议使用await替代.Result，避免在UI线程中出现死锁问题。

额外提示 #

如果需要追踪多层合并（比如从Feature分支合并到Develop，再合并到Main），这个方法也能正确识别，因为它会遍历整个合并链，确保不会遗漏间接合并的情况。

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