TFS二次开发02——链接TFS

在上一篇《TFS二次开发01——TeamProjectsPicher》介绍了  TeamProjectsPicher 对象，使用该对象能够很简单的实现链接TFS。

可是若是咱们要实现自定义的UI客户端 或者咱们要作一个非WinForm版的TFS客户端(好比Web 或者WPF)，那么TeamProjectsPicher 对象就无能为力了。那咱们就只能本身实现了。

这篇文章主要介绍：

1：链接TFS Server

2：获取全部TfsTeamProjectCollection

3：获取某个TfsTeamProjectCollection 下的全部Team Project

 

添加命名空间

using Microsoft.TeamFoundation.Client;

using Microsoft.TeamFoundation.Framework.Client;

using Microsoft.TeamFoundation.Framework.Common;

using Microsoft.TeamFoundation.VersionControl.Client;

1：链接TFS服务器

       //想要链接TFS,确定先要知道TFS 的地址
       string tfsServerURL = "http://192.168.83.70:8080/tfs";
       Uri configurationServerUri = new Uri(tfsServerURL);
       //与TFS服务器链接
       TfsConfigurationServer configurationServer = TfsConfigurationServerFactory.GetConfigurationServer(configurationServerUri);

 

2：获取全部团队项目结合（TfsTeamProjectCollection）

        /// <summary>
        /// 查询全部指定TFS服务上的全部TeamProjectCollection 信息
        /// </summary>
        /// <param name="tfsServerURL"></param>
        /// <returns></returns>
        List<TfsTeamProjectCollection> GetAllTeamProjectCollection(string tfsServerURL)
        {

            Uri configurationServerUri = new Uri(tfsServerURL);

            //与TFS服务器链接
            TfsConfigurationServer configurationServer = TfsConfigurationServerFactory.GetConfigurationServer(configurationServerUri);
          
            List<TfsTeamProjectCollection> lst = new List<TfsTeamProjectCollection>();
            //TFS目录节点
            CatalogNode configurationServerNode = configurationServer.CatalogNode;

            //查询当前TFS下的全部TeamProjectCollection
            ReadOnlyCollection<CatalogNode> tpcNodes = configurationServerNode.QueryChildren(
                    new Guid[] { CatalogResourceTypes.ProjectCollection },
                    false,
                    CatalogQueryOptions.None);

            //遍历每个TeamProjectCollection 节点
            foreach (CatalogNode tpcNode in tpcNodes)
            {
            //获取 当前 team project collection 名称.
                String displayName = tpcNode.Resource.DisplayName;

                // 得到 当前 team project collection 描述.
                String description = tpcNode.Resource.Description;
        
                //获取当前 team project collection 的描述.
                ServiceDefinition tpcServiceDefinition = tpcNode.Resource.ServiceReferences["Location"];
                ILocationService configLocationService = configurationServer.GetService<ILocationService>();
                Uri tpcUri = new Uri(configLocationService.LocationForCurrentConnection(tpcServiceDefinition));

                // 真正的链接到team project collection
                TfsTeamProjectCollection tpc = TfsTeamProjectCollectionFactory.GetTeamProjectCollection(tpcUri);
                lst.Add(tpc);
            }

            return lst;
        }

    TfsTeamProjectCollection 对象经常使用属性：

    TfsTeamProjectCollection. CatalogNode. Resource.DisplayName     // team project collection 名称.

    TfsTeamProjectCollection .Name                 　　　　　　　　　　   // team project collection 名称.

    TfsTeamProjectCollection .Uri                   　　　　　　　　　　　  // team project collection Url 信息.

    TfsTeamProjectCollection. CatalogNode. Resource. Description     // team project collection 描述.

 

3：获取某个TfsTeamProjectCollection 下的全部Team Project信息

      TeamProject[] GetAllTeamProject(TfsTeamProjectCollection tpc)
        {
            List<TeamProject> lst = new List<TeamProject>();
            VersionControlServer version = tpc.GetService(typeof(VersionControlServer)) as VersionControlServer;
            return version.GetAllTeamProjects(true);
        }

因为咱们在实际应用中链接到TFS时，只能链接一个TfsTeamProjectCollection 。因此若是咱们知道了该TfsTeamProjectCollection的Url 那么就能够免去上面的步骤，代码乳以下：

        /// <summary>
        /// 获取全部的TeamProject
        /// </summary>
        /// <returns></returns>
        TeamProject[] GetAllTeamProject(string tpcURL)
        {
            //链接到team project collection ，使用此方式直接链接TFS时 TfsTeamProjectCollection. CatalogNode 为 none 。
            //由于在使用时一般是只链接到一个Team project collection ，全部更多的时候咱们使用这种方式链接TFS
            TfsTeamProjectCollection tpc = new TfsTeamProjectCollection(new Uri(tpcURL));
            //版本控制
            VersionControlServer version = tpc.GetService(typeof(VersionControlServer)) as VersionControlServer;
            //获取全部TeamProject 
            return version.GetAllTeamProjects(true);
        }

结合上面的代码能够实现以下图所示的效果：

4：建立团队项目

            TeamProjectFolderOptions project = new TeamProjectFolderOptions("project1");

            version.CreateTeamProjectFolder(project);