Comando Exibir (Controle de Versão do Team Foundation)

  • Artigo

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

Visual Studio 2019 | Visual Studio 2022

O comando view (TFVC) do Controle de Versão do Team Foundation recupera uma versão específica de um arquivo, armazena-o em uma pasta temporária em seu computador e o exibe.

Pré-requisitos

Para usar o comando view, é necessário ter a permissão de Leitura definida como Permitir. Para saber mais, consulte Permissões padrão do TFVC.

Sintaxe

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>]]

Parâmetros

Veja nas seções a seguir a descrição dos argumentos e das opções do comando view.

Argumentos

Argument

Descrição

<team-project-collection-url>

Fornece a URL da coleção de projetos que contém uma versão específica de um arquivo sobre o qual você deseja recuperar informações, por exemplo, https://myserver:8080/tfs/DefaultCollection.

<shelveset-name> [:<owner>]

Identifica o check-in particular. O argumento <owner> opcional é usado para especificar um check-in particular que não pertence ao usuário atual.

<item-spec>

Identifica o arquivo ou pasta a ser recuperado. Para obter mais informações sobre como o TFVC analisa o argumento <item-spec> para determinar quais itens estão dentro do escopo, consulte Usar os comandos de controle de versão do Team Foundation – Use opções para modificar como um comando funciona.

Observação

Você pode especificar mais de um argumento <item-spec>.

<version-spec>

Fornece um valor como C3 para a opção /version. Para obter mais informações sobre como o TFVC analisa especificação de versão para determinar quais itens estão dentro do escopo, consulte Usar comandos do controle de versão do Team Foundation.

<username>

Mostra um valor para a opção /login. É possível especificar esse valor como DOMAIN\<username> ou <username>.

<password>

Mostra um valor para a opção /login.

<local-file>

Fornece o caminho para a pasta de arquivo de saída.

Opções

Opção

Descrição

/console

Especifica que a saída do arquivo deve ser direcionada para o console. Essa opção será útil se você quiser gravar o arquivo no disco usando o redirecionamento do console, mas usar um nome ou local diferente do item com versão.

/recursive

Exibe todos os itens no diretório especificado e quaisquer subdiretórios.

/shelveset

Especifica o check-in particular pelo nome.

/noprompt

Especifica que o TFVC não deve solicitar antes de exibir cada arquivo quando você incluir uma expressão curinga em um argumento <item-spec> que corresponda a mais de um arquivo.

/version

Especifica a versão do arquivo a ser aberta para exibição. Se você omitir essa opção, view recuperará a versão mais recente do servidor do Azure DevOps.

/collection

Especifica a coleção de projetos.

/login

Especifica o nome de usuário e a senha para autenticar o usuário com o Azure DevOps.

/output

Gera o arquivo para uma pasta local em vez de invocar um shell do Windows para abrir o arquivo.

Comentários

O view comando do tf utilitário da linha de comando recupera uma cópia somente leitura de um arquivo do servidor do Azure DevOps, armazena o arquivo em uma pasta temporária em seu computador e exibe o conteúdo do arquivo. A menos que você estabeleça uma versão específica, o TFVC recuperará a versão mais recente do arquivo do servidor do Azure DevOps.

O comando view não adiciona arquivos ao workspace, nem realiza o check-out deles. Para obter mais informações sobre como obter a versão do servidor do Azure DevOps de um arquivo e marcar-lo, consulte Comando Get e comandos Checkout e Edit.

Você pode usar o comando difference para exibir as diferenças entre duas versões de um arquivo. Para obter mais informações, consulte Comando Difference.

Para obter mais informações sobre como usar o tf utilitário de linha de comando, consulte Usar comandos de controle de versão do Team Foundation.

Opções de saída

  • Por padrão, o TFVC exibe o conteúdo do arquivo no visualizador associado ao seu tipo de arquivo.

  • Se você incluir a opção /console, o TFVC imprimirá o conteúdo do arquivo no console de comando. Da mesma forma, se o TFVC não conseguir localizar um visualizador para o tipo de arquivo especificado, ele imprimirá o conteúdo do arquivo no console de comando.

  • Você pode redirecionar o conteúdo de um arquivo para a saída padrão usando | ou \>. Essa opção fornece uma maneira de salvar o arquivo em outro arquivo ou passá-lo para outro programa para pós-processamento.

Exemplos

O exemplo a seguir exibe a versão mais recente do arquivo 314.cs:

c:\projects>tf view 314.cs

O exemplo a seguir exibe a versão do 314.cs que foi verificada com o conjunto de alterações 1999:

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

O exemplo a seguir recupera a versão 5 de 314.cs e a registra no arquivo 314.old:

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

O exemplo a seguir exibe a versão mais recente de cada arquivo que corresponde à expressão curinga *.cs:

c:\projects>tf view *.cs