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

指定锁类型或从项中移除锁。

锁定选项:

  • 不在项上放置锁。 如果已经有一个锁,则会将它移除。

  • Checkin

    使某个项可在所有工作区中签出并进行编辑,但在您显式释放签入锁之前,将阻止用户签入在指定的 /workspace 之外对项的更改。 如果指定的项已在任何其他工作区中被锁定,则锁定操作将失败。

  • Checkout

    在您显式释放锁之前,阻止用户签入或签出任何一个指定的项。 如果任何其他用户已锁定任何一个指定项,或存在对任何项的现有挂起的更改,则锁定操作将失败。

/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

请参见

任务

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

签入挂起的更改

锁定和取消锁定文件夹或文件

概念

挂起的更改

了解锁定类型

其他资源

Tf 命令行实用工具命令

将文件置于版本控制下