Delete 命令(Team Foundation 版本控制)

更新:2007 年 11 月

从 Team Foundation 版本控制 服务器中移除文件和文件夹,并将其从磁盘中删除。

说明:

在您执行签入操作之前,其他工作区中无法看到此命令的结果。有关更多信息,请参见如何:签入挂起的更改

必需的权限

若要使用 delete 命令,您必须将“签出”权限设置为“允许”。如果在 /lock 选项中包含一个非 none 值,则您必须将“锁定”权限设置为“允许”。此外,您必须是工作区的所有者或者将全局“管理工作区”权限设置为“允许”。有关更多信息,请参见 Team Foundation Server 权限

tf delete [/lock:(none|checkin|checkout)] [/recursive] itemspec

参数

参数

说明

itemspec

标识要从 Team Foundation 版本控制 服务器删除的文件或文件夹。有关 Team Foundation 如何分析项规范以确定哪些项在范围之内的更多信息,请参见命令行选项

选项

说明

/lock

防止其他用户签入或签出指定的项。有关更多信息,请参见了解锁定类型

锁定选项:

  • None

    默认值。不应用锁定。如果您已经在指定的文件上放置了一个锁,此选项会将其移除。此选项不会移除由他人放置的锁。

  • Checkin

    其他用户可以签出指定的项,但在您执行签入前,他们无法签入对锁定文件的修订。如果任何其他用户已锁定任何一个指定的项,则锁定操作将失败。

  • Checkout

    在您执行签入从而释放锁之前,防止其他用户签入或签出任何一个指定的项。如果任何其他用户已锁定任何一个指定的项,则锁定操作将失败。

/recursive

删除与指定目录中的项规范相匹配的所有文件和/或文件夹及子文件夹。

  • tf delete folder1\folder2 /recursive(其中 folder1\folder2 存在且是一个目录)会删除 folder1\folder2 包含的所有文件和子目录以及 folder1\folder2 自身。

  • tf delete folder1\folder2\filespec* /recursive 会删除 folder1\folder2 及其每个子目录中与文件规范相匹配的所有文件和子目录,以及与文件规范相匹配的任何目录中的所有文件和子目录。

    例如,在包含以下各项的工作区中:

    Folder1\AVeryLongDirectoryName(其中包括一些文件)和 Folder1\Folder2\AVeryImportantFile.txt

    tf delete 'Folder1\AVer*' /recursive

    会删除 folder1\folder2\NeverDelete\AVeryImportantFile.txt,因为它与通配符相匹配。

备注

delete 命令在工作区中记录指定项的“删除”类型的挂起更改。当使用** checkin** 命令向 Team Foundation 版本控制服务器提交“删除”类型的挂起更改时,Team Foundation 会将该项从 Team Foundation 版本控制服务器中移除,但不会永久删除它。可以使用 Dir 命令找到 Team Foundation 版本控制 服务器中已删除的项,且可以使用 Undelete 命令 还原已删除的项。

如果您已删除了工作区中的某个项,但还未签入更改,则可以使用 Undo 命令 将该项还原到工作区,并将该删除从挂起的更改列表中移除。

无法删除存在其他挂起更改的项。例如,不能删除已签出的文件。要删除这种项,必须使用 undo 命令撤销当前挂起的更改。

签入挂起的删除时,Team Foundation 会在 Team Foundation 版本控制 服务器中将文件标记为已删除。随后,如果(无论是您还是其他用户)从其他工作区运行该项的 get,将从这些工作区删除该项。

默认情况下,当 itemspec 指定了文件夹时,Team Foundation 将删除该文件夹中的所有文件、子文件夹及子文件夹中包含的文件。

有关如何查找 tf 命令行实用工具的更多信息,请参见 Tf 命令行实用工具命令

示例

下面的示例删除了磁盘上指定的本地工作区文件夹中的 314.cs,然后当您签入更改时,将从版本控制系统中非永久性地移除 314.c。

c:\projects>tf delete 314.cs

请参见

任务

演练:通过命令行使用 Team Foundation 版本控制

如何:移动、重命名和删除受版本控制的文件和文件夹

参考

Undelete 命令

Undo 命令

Dir 命令

其他资源

Tf 命令行实用工具命令