Add 命令
更新：2007 年 11 月
从本地文件系统向 Team Foundation 版本控制 服务器添加新文件和文件夹。
.gif "说明") 说明： |
|---|
在您执行签入操作之前，此命令的结果不会反映在 Team Foundation 版本控制 服务器中。有关更多信息，请参见如何：签入挂起的更改。 |
必需的权限
若要使用 add 命令，您必须是工作区的所有者并且针对该新项的父文件夹将“签出”权限设置为“允许”。如果使用了 /lock:checkout 或 /lock:checkin，您还必须将“锁”权限设置为“允许”。有关更多信息，请参见 Team Foundation Server 权限。
tf add itemspec [/lock:none|checkin|checkout] [/type:filetype]
[/noprompt] [/recursive]
参数
参数 |
说明 |
|---|---|
itemspec |
标识要添加的文件或文件夹。有关 Team Foundation 如何分析项规范以确定哪些项在范围内的更多信息，请参见 命令行语法 (Team System)。 |
filetype |
与 /type 选项一起使用。有关更多信息，请参见文件类型。 |
选项 |
说明 |
|---|---|
/type |
重写文件类型匹配，并将文件添加到使用指定类型的 Team Foundation 版本控制 服务器。有关更多信息，请参见文件类型。 文件类型检测基于文件前一千个字节的内容。 |
/lock |
指定锁类型或从项中移除锁。 锁定选项：
|
/noprompt |
取消显示需要您输入的任何提示。 |
/recursive |
添加指定目录以及任何子目录中的所有项。 |
备注
必须设置本地工作区并建立工作文件夹映射，才能向版本控制添加项。有关如何开始的更多信息，请参见演练：通过命令行使用 Team Foundation 版本控制。
Add 是一个 挂起的更改 命令；该命令安排您指定要添加到 Team Foundation 版本控制 服务器的项等待完成来自于您的工作区的签入操作。若要执行挂起的更改命令，您的当前目录必须映射到工作区和它对应的 Team Foundation 版本控制 服务器。
使用 Add 命令向版本控制中添加新项时，在您签入最近的工作区更改之前，该项不会实际添加到 Team Foundation 版本控制服务器，而是添加到当前工作区的挂起的更改列表中。若要将挂起的添加操作提交到 Team Foundation 版本控制 服务器，可以直接签入添加的文件或签入本地工作区中的所有挂起的更改。如果您担心其他用户可能会在您有机会签入挂起的更改之前，向 Team Foundation 版本控制服务器添加与您挂起的添加项同名的文件或文件夹，则可以包含带有 Checkout 参数的 /lock 选项以防止其他用户执行此操作。有关更多信息，请参见如何：签入挂起的更改。
如果使用 tf add /teamproject/projects/math/314.cs 将 314.cs 添加到版本控制中，那么，在您签入更改之前，这些文件夹中的每一个都将被视为挂起的添加项（如果这些文件夹尚不存在）。当您签入更改时，如果指定路径中的任何文件夹（/teamproject、/teamproject/projects 或 /teamproject/projects/math）在 Team Foundation 版本控制服务器中尚不存在，Team Foundation 将为您创建这些文件夹。
可以使用 Add 命令建立 Team Foundation 版本控制 服务器的初始文件结构。有关更多信息，请参见 演练：通过命令行使用 Team Foundation 版本控制。
有关如何查找 tf 命令行实用工具的更多信息，请参见 Tf 命令行实用工具命令。
示例
下面的示例将文件 314.c 和 1256.c 添加到与工作文件夹 C:\Pi 关联的工作区的挂起的更改列表中。
c:\pi>tf add 314.cs 1256.c
下面的示例将当前目录以及任何子目录中的所有 C# 代码文件 (.cs) 添加到当前工作区的挂起的新项列表中。
c:\projects>tf add *.cs /recursive
下面的示例将当前目录及其所有子文件夹中名称包含“hello”的所有文件和文件夹添加到 c:\projects 映射到的工作区的挂起的新项列表中。
c:\projects>tf add *hello* /recursive
请参见
任务
演练：通过命令行使用 Team Foundation 版本控制