Add 命令
从本地文件系统向 Team Foundation 版本控制 服务器添加文件和文件夹。
提示
在执行签入操作后,此命令的执行结果才会在 Team Foundation 版本控制 服务器中反映出来。 有关更多信息,请参见 签入挂起的更改。
所需权限
若要使用 add 命令,您必须是工作区的所有者并且针对该新项的父文件夹将**“签出”权限必须设置为“允许”。 如果您使用 /lock:checkout 或 /lock:checkin,则必须将“锁定”权限设置为“允许”**。 有关更多信息,请参见 Team Foundation Server 权限。
tf add itemspec [/lock:(none|checkin|checkout)] [/type:filetype]
[/noprompt] [/recursive] [/login:username,[password]]
参数
参数 |
说明 |
---|---|
itemspec |
标识要添加的文件或文件夹。 有关 Team Foundation 如何通过分析 itemspecs 确定范围内项的更多信息,请参见命令行语法(版本控制)。
注意
可指定多个 Itemspec 参数。
|
filetype |
与 /type 选项一起使用。 有关更多信息,请参见 管理文件类型。 |
username |
向 /login 选项提供值。 可以按域\用户名或用户名的格式指定用户名值。 |
选项 |
说明 |
---|---|
/type |
重写文件类型匹配,并将文件添加到使用指定类型的 Team Foundation 版本控制 服务器。 有关更多信息,请参见 管理文件类型。 文件类型检测基于文件前一千个字节的内容。 |
/lock |
指定锁类型或从项中移除锁。 锁定选项:
|
/noprompt |
取消显示需要您输入的任何提示。 |
/recursive |
添加指定目录以及任何子目录中的所有项。 |
/login |
指定用于在 Visual Studio Team Foundation Server 中验证用户身份的用户名和密码。 |
备注
必须设置本地工作区并建立工作文件夹映射,才能向版本控制添加项。
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 版本控制 服务器的初始文件结构。
有关如何查找 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