Share via

view 命令（Team Foundation 版本控制）

  • 项目

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

Visual Studio 2019 | Visual Studio 2022

Team Foundation 版本控制 (TFVC) view 命令检索特定版本的文件，将其存储在计算机上的临时文件夹中，并显示该文件。

先决条件

若要使用 view 命令，必须将“读取”权限设置为“允许”。 有关详细信息，请参阅默认 TFVC 权限。

语法

tf view [/collection:<team-project-collection-url>] [/console] [/recursive] [/output:<local-file>]
[/shelveset:<shelveset-name>[;<owner>]] [/noprompt] <item-spec> 
[/version:<version-spec>] [/login:<username>,[<password>]]

参数

以下各部分介绍 view 命令的参数和选项。

参数

Argument

说明

<team-project-collection-url>

提供包含要检索其信息的文件的特定版本的项目集合的 URL，例如 https://myserver:8080/tfs/DefaultCollection。

<shelveset-name> [:<owner>]

标识搁置集。 可选的 <owner> 参数用于指定不归当前用户所有的搁置集。

<item-spec>

标识要检索的文件或文件夹。 若要详细了解 TFVC 如何分析 <item-spec> 参数以确定哪些项在范围内，请参阅使用 Team Foundation 版本控制命令 - 使用选项修改命令的运行方式。

注意

可指定多个 <item-spec> 参数。

<version-spec>

为 /version 选项提供一个值，例如 C3。 若要详细了解 TFVC 如何分析版本规范以确定哪些项在其范围内，请参阅使用 Team Foundation 版本控制命令。

<username>

为 /login 选项提供值。 可以将此值指定为 DOMAIN\<username> 或 <username>。

<password>

为 /login 选项提供值。

<local-file>

提供输出文件文件夹的路径。

选项

选项

说明

/console

指定应将文件输出定向到控制台。 如果要使用控制台重定向将文件写入磁盘，但使用的名称或位置与版本控制项的不同，则此选项适用。

/recursive

在指定目录以及任何子目录中查看所有项。

/shelveset

按名称指定搁置集。

/noprompt

指定在以下情况中 TFVC 应在显示每个文件后再发出提示：在 <item-spec> 参数中包含一个匹配多个文件的通配符表达式。

/version

指定要打开以供查看的文件的版本。 如果省略此选项，则 view 检索最新的 Azure DevOps 服务器版本。

/collection

指定项目集合。

/login

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

/output

将文件输出到本地文件夹，而不是调用 Windows shell 来打开该文件。

注解

tf 命令行实用工具的 view 命令从 Azure DevOps 服务器检索文件的只读副本，将该文件存储在计算机上的临时文件夹中，并显示文件内容。 除非指定特定版本，否则 TFVC 将从 Azure DevOps 服务器检索文件的最新版本。

view 命令不会将文件添加到工作区或签出文件。若要详细了解如何获取文件的 Azure DevOps 服务器版本以及如何将其签出，请参阅 get 命令和 checkout 和 edit 命令。

可以使用 difference 命令查看文件的两个版本之间的差异。 有关详细信息，请参阅 difference 命令。

若要详细了解如何使用 tf 命令行实用工具，请参阅使用 Team Foundation 版本控制命令。

输出选项

  • 默认情况下，TFVC 在查看器中显示与其文件类型关联的文件的内容。

  • 如果包含 /console 选项，TFVC 会将文件的内容输出到命令控制台。 同样，如果 TFVC 找不到指定文件类型的查看器，它会将文件内容输出到命令控制台。

  • 可以使用 | 或 \> 将文件内容重定向到标准输出。 此选项提供了一种方法，可将文件保存到另一个文件或将其传递给另一个程序进行后期处理。

示例

以下示例显示文件 314.cs 的最新版本：

c:\projects>tf view 314.cs

以下示例显示使用变更集 1999 签入的 314.cs 的版本：

c:\projects>tf view /version:C1999 314.cs

以下示例检索 314.cs 版本 5 并将其写入文件 314.old：

c:\projects>tf view /version:5 314.cs > 314.old

以下示例显示与通配符表达式 *.cs 匹配的每个文件的最新版本：

c:\projects>tf view *.cs