Compartilhar via

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 TFVC (Controle de Versão do Team Foundation) view 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, tenha a permissão Ler definida como Permitir. Para obter mais informações, consulte permissões TFVC padrão.

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

As seções a seguir descrevem argumentos e opções do comando view.

Argumentos

de argumento

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 sobre, por exemplo, https://myserver:8080/tfs/DefaultCollection.

<shelveset-name> [:<owner>]

Identifica o conjunto de prateleiras. O argumento <owner> opcional é usado para especificar um conjunto de prateleiras 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 comandos de controle de versão do Team Foundation – Use opções para modificar como um comando funciona.

Nota

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 uma especificação de versão para determinar quais itens estão dentro de seu escopo, consulte Usar comandos de controle de versão do Team Foundation.

<username>

Fornece um valor para a opção /login. Você pode especificar esse valor como DOMAIN\<username> ou <username>.

<password>

Fornece 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 conjunto de prateleiras 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.

Observações

O comando view do utilitário de linha de comando tf 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ê especifique 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 faz check-out. Para obter mais informações sobre como obter a versão do servidor do Azure DevOps de um arquivo e fazer check-out, consulte Obter comandos e comandos checkout e editar.

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

Para obter mais informações sobre como usar o utilitário de linha de comando tf, 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 de 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 grava 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