Delete 命令（Team Foundation 版本控制）

  • 项目

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

delete 命令从 Azure DevOps Server 中移除文件和文件夹，并将它们从磁盘中删除。

注意

在执行签入操作之前，此命令的结果在其他工作区中不可见。 有关详细信息，请参阅开发代码和管理挂起的更改。

先决条件

要使用 delete 命令，必须将“签出”权限设置为“允许”。 如果将 /lock 选项的值设为 none 以外的值，必须将“锁定”权限设置为“允许”。 还必须拥有工作区或将全局“管理工作区”权限设置为“允许”。 有关详细信息，请参阅默认 TFVC 权限。

语法

tf delete [/lock:(none|checkin|checkout)] [/recursive] [/login:username,[password]] itemspec

参数

参数

Argument

说明

<itemspec>

标识要从 Azure DevOps Server 中删除的文件或文件夹。 要详细了解 TFVC 如何分析 itemspec 以确定哪些项在范围内，请参阅使用选项修改命令的运行方式。

注意

可指定多个 itemspec 参数。

<username>

为 /login 选项提供值。 你可将用户名值指定为 DOMAIN\username 或 username。

选项

选项

说明

/lock

阻止其他用户签入或签出指定项。 有关详细信息，请参阅了解锁定类型。

锁定选项：

  • none
    默认。 未应用锁定。 如果你已对指定文件应用了锁定，则此选项会将该锁定删除。 它不会删除其他人应用的锁定。

  • checkin
    其他用户可以签出指定项，但在你解除签入锁定之前，他们无法签入对锁定文件的修订。 如果任何其他用户已经锁定了任何指定项，锁定操作将失败。

  • checkout
    在你解除签入锁定之前，此选项会阻止其他用户签入或签出任何指定项。 如果任何其他用户已经锁定了任何指定项，锁定操作将失败。

/recursive

从指定目录中删除与 itemspec 匹配的所有文件和/或文件夹与子文件夹。

  • tf delete <folder1>\<folder2> /recursive 删除 <folder1>\<folder2> 包含的所有文件和子目录，以及 <folder1>\<folder2> 本身。
  • tf delete <folder1>\<folder2> <filespec> /recursive 删除与 <folder1>\<folder2> 及其每个子目录中包含的 filespec 匹配的所有文件和子目录，以及与 filespec 匹配的任何目录中包含的所有文件和子目录。

例如，在包含以下项的工作区中：

其中存在某些文件的 Folder1\AVeryLongDirectoryName 以及 Folder1\Folder2\AVeryImportantFile.txt，

tf delete Folder1 AVer* /recursive

删除 Folder1\AVeryLongDirectoryName 及其所有文件，并删除 Folder1\Folder2\AVeryImportantFile.txt，因为该文件与通配符匹配。

/login

指定用户名和密码，以便使用 Azure DevOps 对用户进行身份验证。

注解

delete 命令会在工作区中为你指定的项记录一条 delete 类型的挂起的更改。 使用 checkin 命令将一条 delete 类型的挂起的更改提交到 Azure DevOps Server 时，TFVC 会从 Azure DevOps Server 中移除该项，但不会将其永久删除。 可使用 dir 命令在 Azure DevOps Server 中找到已删除的项，还可使用 Undelete 命令还原已删除的项。

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

如果一个项存在另一个挂起的更改，则无法将其删除。 例如，无法删除已签出的文件。 要删除此类项，必须使用 undo 命令撤消当前挂起的更改。

当你签入挂起的删除时，TFVC 会在 Azure DevOps Server 中将该文件标记为已删除。 随后当你或其他用户从其他工作区运行该项的 get 时，将会从这些工作区中删除该项。

itemspec 指定文件夹时，默认情况下，TFVC 会删除该文件夹的所有文件和子文件夹以及它们包含的文件。

有关如何使用 tf 命令行实用工具的详细信息，请参阅使用 Team Foundation 版本控制命令。

示例

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

tf delete 314.cs