这将在签入时提供附加到所有更改集的特定工作项的文件列表。至少它解决了我的目的。
参考：http://obscureproblemsandgotchas.com/uncategorized/how-to-get-all-files-modified-for-work/
using System;
using System.Collections.Generic;
using System.Linq;
using Microsoft.TeamFoundation;
using Microsoft.TeamFoundation.Client;
using Microsoft.TeamFoundation.VersionControl.Client;
using Microsoft.TeamFoundation.WorkItemTracking.Client;
/// <summary>
/// Wrapper class for performing basic TFS queries
/// </summary>
public class TfsUtilities
{
public string TfsUri { get; private set; }
TfsTeamProjectCollection Server { get; set; }
VersionControlServer VersionCS { get; set; }
WorkItemStore Store { get; set; }
/// <summary>
/// Initialize this class to work with the specified Server (URI)
/// </summary>
/// <param name="tfsUri">The URI for the desired TFS server</param>
public TfsUtilities(string tfsUri)
{
TfsUri = tfsUri;
Server = GetServer();
VersionCS = Server.GetService(typeof(VersionControlServer)) as VersionControlServer;
Store = new WorkItemStore(Server);
}
/// <summary>
/// Get a reference to the specified server
/// </summary>
/// <returns>TFS Server at Collection Level</returns>
private TfsTeamProjectCollection GetServer()
{
return TfsTeamProjectCollectionFactory.GetTeamProjectCollection(new Uri(TfsUri));
}
/// <summary>
/// Get items recursively in TFS via a direct TFS path.
/// </summary>
/// <param name="tfsPath">A path in the current TFS server</param>
/// <returns>All items found</returns>
public ItemSet GetTeamProjectItems(string tfsPath)
{
ItemSet items = VersionCS.GetItems(@"$" + tfsPath, RecursionType.Full);
//ItemSet items = version.GetItems(@"$ProjectNameFileName.cs", RecursionType.Full);
foreach (Item item in items.Items)
System.Console.WriteLine(item.ServerItem);
return items;
}
/// <summary>
/// Query for all or a specific work item in a team project
/// </summary>
/// <param name="teamProject">team project name</param>
/// <param name="workItemID">Optional - work item ID</param>
/// <returns>Work Item Collection</returns>
public WorkItemCollection GetWorkItems(string teamProject, int workItemID = 0)
{
string strSQL =
" SELECT [System.Id], [System.WorkItemType]," +
" [System.State], [System.AssignedTo], [System.Title] " +
" FROM WorkItems " +
" WHERE [System.TeamProject] = '" + teamProject +"' ";
if (workItemID > 0)
strSQL += " AND [System.Id] = " + workItemID;
strSQL += " ORDER BY [System.WorkItemType], [System.Id]";
WorkItemCollection workItems = Store.Query(strSQL);
foreach(WorkItem item in workItems)
Console.WriteLine(item.Id);
return workItems;
}
/// <summary>
/// Get all of the Files/Items that were modified and associated with a Work Item
/// </summary>
/// <param name="teamProject">Name of the Team Project</param>
/// <param name="workItemID">The work item ID</param>
/// <returns>List of changes</returns>
public List<FileItem> GetAllFilesModifiedForWorkItem(string teamProject, int workItemID)
{
WorkItemCollection workItems = GetWorkItems(teamProject, workItemID);
if (workItems.Count == 0)
{
Console.WriteLine("No Items found for Work Item ID: " + workItemID);
return null;
}
WorkItem item = workItems[0];
Console.WriteLine("Work Item {0} has {1} Links", workItemID, item.Links.Count);
if(item.Links.Count == 0)
return null;
List<Changeset> lstChangesets = GetChangesets(item.Links);
Console.WriteLine("Work Item {0} has {1} Changesets", workItemID, lstChangesets.Count);
if (lstChangesets.Count == 0)
return null;
List<FileItem> lstItems = GetItemsForChangeset(lstChangesets);
Console.WriteLine("Work Item {0} has {1} Items (changes)", workItemID, lstItems.Count);
if (lstItems.Count == 0)
return null;
return lstItems;
}
/// <summary>
/// Get all of the items, regardless of duplicates, changed for each provided changeset
/// </summary>
/// <param name="changesets"></param>
/// <returns></returns>
public List<FileItem> GetItemsForChangeset(List<Changeset> changesets)
{
List<FileItem> lst = new List<FileItem>();
foreach (Changeset obj in changesets)
{
Console.WriteLine("Changeset {0} has {1} Items", obj.ChangesetId, obj.Changes.Length);
lst.AddRange(GetItemsForChangeset(obj));
}
return lst;
}
/// <summary>
/// Get all of the changed files/items associated with this changeset
/// </summary>
/// <param name="changeset"></param>
/// <returns></returns>
public List<FileItem> GetItemsForChangeset(Changeset changeset)
{
FileItem t = null;
List<FileItem> lst = new List<FileItem>();
foreach (Change obj in changeset.Changes)
{
t = new FileItem() { CheckinDate = obj.Item.CheckinDate, ChangeType = obj.ChangeType, TfsPath = obj.Item.ServerItem };
Console.WriteLine("Item {0} : {1} - {2} - {3}", obj.Item.ItemId, t.CheckinDate, t.ChangeType, t.TfsPath);
lst.Add(t);
}
return lst;
}
/// <summary>
/// Get all of the Changesets from a collection of links (Links in a Work Item)
/// </summary>
/// <param name="workItemLinks">The links of a work item</param>
/// <returns>All of the found changesets - can be returned empty</returns>
public List<Changeset> GetChangesets(LinkCollection workItemLinks)
{
Changeset cs = null;
List<Changeset> lst = new List<Changeset>();
foreach (Link obj in workItemLinks)
{
cs = ConvertToChangeSet(obj);
if (cs != null)
lst.Add(cs);
}
return lst;
}
/// <summary>
/// Convert the provided Link to a Changeset.
/// If the conversion cannot be made, null is returned.
/// </summary>
/// <param name="workItemLink">Work Item Link</param>
/// <returns>Changeset or null</returns>
public Changeset ConvertToChangeSet(Link workItemLink)
{
Changeset cs = null;
ExternalLink externalLink = workItemLink as ExternalLink;
if (externalLink != null)
{
ArtifactId artifact = LinkingUtilities.DecodeUri(externalLink.LinkedArtifactUri);
if (String.Equals(artifact.ArtifactType, "Changeset", StringComparison.Ordinal))
{
// Convert the artifact URI to Changeset object.
cs = VersionCS.ArtifactProvider.GetChangeset(new Uri(externalLink.LinkedArtifactUri));
}
}
return cs;
}
//http://stackoverflow.com/questions/3619078/what-is-the-fastest-method-of-retrieving-tfs-team-projects-using-the-tfs-sdk-api
/// <summary>
/// Get all of the Team Project Names for the current TFS Server's Collection
/// </summary>
/// <returns>List of team project names</returns>
public List<string> GetTeamProjectNames()
{
return Server.GetService<VersionControlServer>()
.GetAllTeamProjects(false)
.Select(x => x.Name)
.ToList();
}
}
//Code for the FileItem class (not entirely necessary)
using System;
using Microsoft.TeamFoundation.VersionControl.Client;
public class FileItem
{
public DateTime CheckinDate { get; set; }
public string ChangeTypeString
{
get { return ChangeType.ToString(); }
}
public ChangeType ChangeType { get; set; }
public string TfsPath { get; set; }
}