查看命令 (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 命令的参数和选项。

参数

参数

说明

<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

指定在 <item-spec> 参数中包含匹配多个文件的通配符表达式时,TFVC 不应在显示每个文件时提示你。

/version

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

/collection

指定项目集合。

/login

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

/output

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

言论

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

view 命令不会将文件添加到工作区或签出文件。有关如何获取文件的 Azure DevOps 服务器版本并将其签出的详细信息,请参阅 获取命令签出和编辑命令

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

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

输出选项

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

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

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

例子

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

c:\projects>tf view 314.cs

以下示例显示使用 changeset 1999 签入的 314.cs 的版本:

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

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

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

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

c:\projects>tf view *.cs