Team Foundation 的命名限制

  • 项目

更新：2010 年 12 月

Visual Studio Team Foundation Server 中许多组件的命名都具有特定的限制。 这些限制有助于保证一致的用户体验，并提供与其他程序的兼容性。 这些限制可包括长度、特殊字符、唯一性或其他特性。

本主题包含以下小节：

一般注意事项

Team Foundation Server 组帐户名限制

计算机名称限制

团队项目集合名称限制

团队项目名称限制

工作项限制

工作项自定义限制

过程模板限制

Team Foundation Build 限制

版本控制限制

请参见

一般注意事项

本主题中的长度限制表示为允许的 Unicode 字符的数量。 有关 Unicode 的更多信息，请参见“About Unicode and Character Sets”（关于 Unicode 和字符集）(https://go.microsoft.com/fwlink/?LinkId=76837)。 代理项字符由两个 Unicode 字符组成，长度限制中会将其算作两个字符。

与其他操作系统文件一样，还禁止 ASCII 控制字符 (ASCII 1-31) 和代理项的组合形式。 有关操作系统对文件名的限制的一般信息，请参见“Naming a File”（文件命名）(https://go.microsoft.com/fwlink/?LinkId=76838)。

Team Foundation Server 组帐户名限制

Team Foundation 组帐户允许您将特定权限应用到一组用户。 Team Foundation 组可以由 Windows 用户帐户、Windows 组帐户、Active Directory 组帐户、Team Foundation 组帐户或这些帐户类型的任意组合构成。

如果您要创建一个拥有跨多个项目的权限的组，请参见 创建集合级别组。 如果要为您的团队项目创建安全组，请参见 创建团队项目组。 如果要向某个在 Team Foundation Server 中预定义的组添加新成员，请参见向团队项目中添加用户。

创建或更改 Team Foundation 组帐户时，必须遵循特定的 Team Foundation Server 限制。 下表描述了这些限制。

限制类型

限制

组帐户名长度

  • 不能超过 256 个 Unicode 字符

唯一性（集合级别组帐户）

  • 不能与团队项目集合中的组帐户的任何其他名称匹配

唯一性（项目级别组帐户）

  • 不能与同一项目中的任何其他组名匹配

保留的组名

  • 项目和服务器级别上都不能命名为 $NAMESPACE

特殊字符限制

  • 不能包含以下可打印字符："/ \ [ ] : | < > + = ; ? *

  • 不能包含 ASCII 值在 1-31 范围内的不可打印字符

  • 不能以句点 (.) 结束

  • 不能包含逗号 (,)

提示

您不在 Team Foundation Server 中创建用户帐户。 在某些情况下，可能要将特定的 Windows 用户添加到 Team Foundation 组或添加到 Team Foundation Server 本身。 有关更多信息，请参见直接将用户添加到团队项目或团队项目集合。

计算机名称限制

在 Team Foundation Server 安装过程中，计算机名称与 Team Foundation 服务器的名称相关联。

操作系统和 Windows Server 2003 Active Directory 都对计算机名称有特定的限制规定。 有关重命名计算机的更多信息，请参见“Rename a Computer”（重命名计算机）(https://go.microsoft.com/fwlink/?LinkId=76839)。 有关 Active Directory 的更多信息，请参见“Windows Server 2003 Active Directory”(https://go.microsoft.com/fwlink/?LinkId=47541)。

团队项目集合名称限制

团队项目集合的名称标识一组团队项目和与这些项目关联的资源。 团队项目集合是用于在 Team Foundation Server 中定义和控制一组团队项目的组织结构。 团队成员在连接到团队资源管理器中的团队项目时，将使用团队项目集合的名称。有关更多信息，请参见使用团队项目集合组织服务器。

下表描述了对集合名称的限制。

限制类型

限制

Length

  • 不能超过 64 个 Unicode 字符

唯一性

  • 不能与 Team Foundation Server 部署中的任何其他集合名称相同。

  • 如果部署包括 SharePoint 产品或 SQL Server Reporting Services，则不能与现有 SharePoint 站点、报表服务器或 Reporting Services 网站的名称和完整路径相同。

特殊字符

  • 不能包含任何 Unicode 控制字符或代理项字符。

  • 不能包含以下可打印字符：/ : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ]

  • 不能包含省略号 (…) 或双句点 (..)

  • 不能以下划线 (_) 开头

  • 不能以句点 (.) 开头或结束

保留名称

  • 不能为系统保留名称，如 PRN、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM10、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、NUL、CON、AUX、Web 或 WEB

    有关保留名称的更多信息，请参见 Microsoft 网站上的以下页面：File Names, Paths, and Namespaces（文件名、路径和命名空间）。

项目名称限制

Team Foundation Server 中的项目名称标识一个组成特定 Team Foundation 项目的集合，集合中包含工作项、文档、报表、团队项目生成以及版本控制树。 团队成员将使用此项目名称连接到 Team Foundation Server 中的项目。

下表描述了对项目名称的限制。

限制类型

限制

长度

  • 不能超过 64 个 Unicode 字符

唯一性

不能与团队项目集合、支持该集合的 SharePoint Web 应用程序或支持该集合的 SQL Server Reporting Services 实例中的任何其他名称相同

特殊字符

  • 不能包含任何 Unicode 控制字符或代理项1 字符

  • 不能包含以下可打印字符：/ : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ]

  • 不能包含省略号 (…) 或双句点 (..)

  • 不能以下划线 (_) 开头

  • 不能以句点 (.) 开头或结束

保留名称

  • 不能为系统保留名称，如 PRN、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM10、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、NUL、CON 或 AUX

  • 有关保留名称的更多信息，请参见“Naming a File”（文件命名）(https://go.microsoft.com/fwlink/?LinkId=76838)

工作项限制

Microsoft Visual Studio Application Lifecycle Management 使用诸如缺陷、要求、任务和风险等项来跟踪项目的进度。 这些项统称为工作项。 本部分描述对存储在工作项中的数据的限制。

工作项附件限制

可以将文件附加到工作项。 下表描述了对工作项附件的限制。

限制类型

限制

文件大小

  • 默认情况下，工作项文件附件的大小限制是 4,096 KB。 该值可以由 Team Foundation 管理员更改。 管理员可设置的最大大小为 2 GB。

  • 默认大小：4,096 KB

  • 最大大小：2 GB

工作项区域和迭代限制

工作项包含一个用于**“项目区域”的字段和一个用于“项目迭代”**的字段。 这两个字段用于按逻辑分组组织和显示工作项。

**“项目区域”和“项目迭代”**是由多个节点项组成的路径，节点项之间以反斜杠 (\) 字符分隔。 节点由 Team Foundation Server 管理员定义，反映项目区域和项目周期。 下表描述了对节点和路径的限制。

限制类型

限制

节点长度

  • 不能超过 255 个字符

节点的特殊字符

  • 不能包含 Unicode 控制字符

  • 不能包含任何以下字符：\ / $ ? * : " & > < # % |

  • 不能包含本地文件系统禁止的字符。 有关 Windows 字符限制的更多信息，请参见“Naming a File”（文件命名）(https://go.microsoft.com/fwlink/?LinkId=76838)

保留名称

  • 不能仅由一个句点 (.) 或两个句点 (..) 组成

  • 不能为系统保留名称，如 PRN、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM10、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、NUL、CON 或 AUX

  • 有关保留名称的更多信息，请参见“Naming a File”（文件命名）(https://go.microsoft.com/fwlink/?LinkId=76838)

路径长度

  • 不能超过 4000 个 Unicode 字符

路径层次深度

  • 不能超过 14 层

工作项自定义限制

Team Foundation Server 使用诸如缺陷、要求、任务和风险等项来跟踪项目的进度。 这些项统称为工作项。

团队项目的管理员可以决定在项目级别上或在过程模板中更改工作项类型定义。 有关如何自定义工作项类型的更多信息，请参见自定义项目跟踪数据、窗体、工作流及其他对象。 本节描述了您在自定义工作项和与工作项关联的元素时将遇到的限制。

工作项字段名称限制

每个工作项类型包含一个或多个工作项字段。 这些字段定义了存储在工作项类型中的信息。 工作项字段名称唯一标识每个工作项字段。

下表描述了对工作项字段名称的限制。

限制类型

限制

长度

不能超过 128 个 Unicode 字符

特殊字符

  • 不能包含前导或拖尾空格

  • 不能包含两个或更多连续空格

  • 不能包含句点 (.)

  • 不能包含左方括号或右方括号 ([ ])

范围

  • 工作项字段名称作用于整个 Team Foundation 服务器。 如果更改字段名称，则此更改将反映在包含该工作项字段的所有项目和工作项类型中。

工作项字段引用名称限制

每个工作项字段都有一个关联的字段引用名称。 字段引用名称唯一标识每个字段，在指定后便不能更改。 有关字段引用名称的更多信息，请参见Field Reference Names。 下表描述了对字段引用名称的限制。

限制类型

限制

长度

  • 不能超过 70 个 Unicode 字符

特殊字符

  • 不能包含连字符 (-)

  • 必须至少包含一个句点 (.)

  • 不能以句点 (.) 开头或结束

  • 不能以数字开头

  • 不能以下划线 (_) 开头

唯一性

  • 不能与 Team Foundation Server 中的任何其他字段引用名称相同

  • 在计算机使用下划线 (_) 替换这些名称中的所有句点 (.) 之后，该字段引用名称不能与任何其他字段引用名称相同

    例如，字段引用名称 My._Field 和 My_.Field 都将被计算机处理为同一名称：My__Field

工作项字段帮助文本限制

您可以选择通过使用 <HELPTEXT> 标记将帮助文本与工作项字段关联。 系统将在运行时显示此文本，以帮助用户了解应在字段中输入哪些内容。 有关工作项字段帮助文本的更多信息，请参见为工作项字段定义帮助文本。

下表描述了对工作项字段帮助文本的限制。

限制类型

限制

长度

  • 不能超过 255 个 Unicode 字符

范围

与字段名和字段类型不同，字段帮助文本的应用范围限定为特定团队项目中的特定工作项类型。

全局列表限制

全局列表是列表项值的集合，该集合由所有 Team Foundation Server 在 Team Foundation Server 实现中存储并在全局范围使用。 在定义工作项类型时，您可能会发现一些工作项字段共享一组相同的可能值。 使用全局列表可以一次定义这些值并在多个工作项类型中共享这些值。 有关更多信息，请参见定义全局列表。

全局列表 (GLOBALLIST) 包含一个或多个列表项（LISTITEM 元素）。

下表描述了对列表项的限制。

限制类型

限制

长度

  • 不能超过 254 个 Unicode 字符

  • 不能为空

特殊字符

  • 不能包含前导或拖尾空白

  • 不能包含两个连续空格

  • 不能包含反斜杠 (\) 字符

范围

  • 因为全局列表在所有项目中都可用，所以不能包含在项目级别定义的元素，例如项目特定的组帐户定义。

下表描述了对全局列表的限制。

限制类型

限制

项个数

全局列表不能为空。 它必须至少包含一个 LISTITEM 元素。

唯一性

  • 全局列表名称不能与 Team Foundation Server 中的任何其他全局列表名称相同。

过程模板限制

过程模板是默认工作项、工作项查询、产品模板、报告、安全组和指南的集合，它影响 Team Foundation 项目的结构。 Team Foundation Server 包含两个默认的过程模板，从而提供两种不同的软件周期管理风格。 可以自定义这些模板以满足您的组织的独特需求。 有关更多信息，请参见自定义过程模板。

下表描述了对过程模板的限制。

限制类型

限制

过程模板名称长度

不能超过 256 个 Unicode 字符。

过程模板名称的唯一性

  • 必须在 Team Foundation 服务器内保持唯一。

  • 如果上载与现有模板名称相同的模板，则将覆盖现有模板。

过程模板文件大小

过程模板文件大小不能超过 2 GB（兆字节）。

Team Foundation Build 限制

Team Foundation Build 允许在一台计算机上管理生成过程的所有方面。 通过使用 Team Foundation Build，您可以同步源代码、编译应用程序、运行关联的单元测试、执行代码分析、在文件服务器上发布生成，以及发布生成报告。

生成计算机限制

Team Foundation Build 是独立于 Team Foundation Server 应用层、数据层或 Visual Studio 客户端的单独安装。 您可以指定单独的计算机。 或者，也可以将生成版本并行安装在客户端计算机或服务器上。

下表描述了对生成计算机的限制。

限制类型

限制

磁盘空间

必须具有足够的磁盘空间用于生成（磁盘空间不足将导致生成失败）。

生成目录

必须为本地路径（例如，C:\生成目录）。

放置位置目录

必须为 UNC 路径（例如，\\server\share）。

放置位置权限

每个生成的版本都放在放置文件夹中的新目录中。

  • Team Foundation Server Service 帐户（例如“域\TFSSERVICE”）对 UNC 放置位置必须具有“完全控制”权限。

  • UNC 放置位置必须为共享文件夹。

Team Foundation 生成服务帐户

如果在初始安装后更改 Team Foundation Server Service 帐户，则必须确保符合以下条件。

  • 该帐户为“Build Services”组的成员。

  • 该帐户对临时文件夹和 ASP.NET 临时文件夹有读/写权限。

  • 该帐户对生成目录和放置位置具有“完全控制”权限。

防火墙问题

如果生成计算机启用了防火墙，则请确保 tfsbuildservice 程序位于例外列表中。

生成类型名称

Team Foundation Build 使用生成类型来配置将在团队项目中生成单个解决方案或一组解决方案的条件。 若要完成生成，必须创建新生成类型或使用现有的生成类型。 有关生成类型的更多信息，请参见定义生成过程。

下表描述了对生成类型名称的限制。

限制类型

限制

唯一性

不能与项目中的任何其他生成类型名称相同

特殊字符

  • 不能包含以下可打印字符：$

生成质量名称

生成质量允许向完成的生成附加质量级别或完成状态。 Team Foundation Build 还允许为生成质量类型创建新值。 有关更多信息，请参见创建基本生成定义。 有关默认生成质量值的列表，请参见对已完成生成的质量进行评级。

下表描述了对生成质量名称的限制。

限制类型

限制

长度

不能超过 256 个 Unicode 字符

唯一性

不能与 Team Foundation Build 计算机中的任何其他生成质量名称相同

版本控制限制

Team Foundation 版本控制提供了一个中央存储库，用于存储团队中的文件以及管理这些文件所需的命令。 还提供可自定义的签入策略、分支、合并、搁置以及许多其他功能。

版本控制服务器路径

版本控制服务器路径是存储在版本控制中的文件的完全限定路径位置。

下表描述了对版本控制服务器路径长度的限制。

限制类型

限制

长度

  • 目录不能超过 248 个 Unicode 字符。

  • 目录和文件名加起来不能超过 260 个 Unicode 字符。

向版本控制添加文件

版本控制系统存储许多不同类型的文件。 有关如何将现有 Visual Studio 项目或解决方案添加到版本控制中的更多信息，请参见将文件置于版本控制下。 也可以添加与 Visual Studio 项目或解决方案不关联的文件或文件夹。 有关更多信息，请参见向版本控制中添加非项目或非解决方案文件和文件夹。

下表描述了应用于要添加到版本控制中的文件和文件夹的限制。

限制类型

限制

文件扩展名

  • 不能包含以下可打印字符：/ \ : * ?" < > |

文件夹

  • 不能为空

  • 不能包含有挂起的更改的文件

  • 不能位于活动工作区的映射目录之外

标签名称

在 Team Foundation 版本控制中，标签是应用于特定修订集的名称。 可以向版本控制中的一组不相关文件附加标签。 这使您能够将这些文件作为组进行检索或处理。 有关更多信息，请参见使用标签获取文件快照。 下表描述了对标签名称的限制。

限制类型

限制

长度

不能超过 64 个 Unicode 字符

特殊字符

  • 不能以空格 ( ) 或句点 (.) 结束

  • 不能包含以下可打印字符：" / : < > \ | * ? @

搁置集

通过使用搁置集，您可以暂时保留一批挂起的更改，并可以选择在以后从您的工作区移除这些挂起的更改。 您可以在以后将搁置集中的更改还原到您的工作区中或将这些更改放入其他用户的工作区。 有关更多信息，请参见使用搁置集。

下表描述了对搁置集名称的限制。

限制类型

限制

长度

不能超过 64 个 Unicode 字符

特殊字符

  • 不能包含以下可打印字符：" / : < > \ | * ? ;

工作区名称

工作区是 Team Foundation 版本控制中文件和文件夹的客户端副本。 创建多个工作区时，客户端计算机上可以有同一版本控制文件夹的不同版本。 有关工作区的更多信息，请参见创建工作区以使用团队项目。 下表描述了对工作区名称的限制。

限制类型

限制

长度

不能超过 64 个 Unicode 字符

特殊字符

  • 不能以空格 ( ) 结尾

  • 不能包含以下可打印字符：" / : < > \ | * ? ;

请参见

任务

创建集合级别组

创建团队项目组

向默认组中添加用户

直接将用户添加到团队项目或团队项目集合

创建基本生成定义

对已完成生成的质量进行评级

向版本控制中添加非项目或非解决方案文件和文件夹

概念

自定义项目跟踪数据、窗体、工作流及其他对象

为工作项字段定义帮助文本

定义全局列表

使用标签获取文件快照

使用搁置集

创建工作区以使用团队项目

其他资源

自定义过程模板

定义生成过程

将文件置于版本控制下

Field Reference Names

修订记录

日期

修订记录

原因

2010 年 12 月

更新了有关搁置集和工作区名称限制的信息。

客户反馈

2010 年 10 月

更新了有关团队项目名称所需的唯一性的信息。

客户反馈