Comando de diferença

Compara e se for possível, exibe as diferenças entre dois arquivos, arquivos de duas pastas, ou um shelveset e um local ou um arquivo do servidor.

Permissões necessárias

Para usar o difference de comando, você deve ter o leitura o conjunto de permissões especificado todos os itens Permitir. For more information, see Permissões de Team Foundation Server.

tf diff[erence] itemspec [/version:versionspec] [/type:filetype] 
[/format:format [/ignorespace] [/ignoreeol] [/ignorecase] [/recursive] 
[/options][/noprompt][/login:username,[password]]

tf diff[erence] itemspec itemspec2 [/type:filetype] [/format: format] 
[/ignorespace] [/ignoreeol] [/ignorecase] [/recursive] [/options] [/noprompt][/login:username,[password]]

tf diff[erence] [/shelveset:shelvesetname[;shelvesetowner]] 
shelveset_itemspec [/type:filetype] 
[/format: format] [/ignorespace] [/ignoreeol] [/ignorecase] 
[/recursive] [/options] [/noprompt][/login:username,[password]]

tf diff[erence] /configure

Parâmetros

Argument

Description

itemspec

Required. Especifica o item a ser comparada. Se nenhuma versão ou o caminho for especificado, o versão atual do espaço de trabalho é assumido. Aceita locais e Controle de versão do Team Foundation caminhos do servidor.

Para obter mais informações sobre como Team Foundation itemspecs analisa para determinar quais itens estão dentro do escopo, consulte Sintaxe de linha de comando (controle de versão).

O difference comando não suporta todos os caracteres curinga.

Este parâmetro não pode ser combinado com o /shelveset opção.

Itemspec2

Optional. O item ao qual o itemspec deve ser comparada. Se você não fornecer um segundo itemspec, a última Controle de versão do Team Foundation versão do servidor do item é usado.

Filetype

Fornece um valor para o /type opção. Você pode especificar "binário" ou "texto" e um número de página de código ou o nome amigável para uma página de código.

Format

Usado com o /format opção para especificar um formato de saída de um dos seguintes tipos:

  • Visual

  • Brief

  • Context

  • RCS

  • SS

  • SS_SideBySide

  • SS_Unix

  • Unificação

  • Unix

Esses formatos de saídas são explicados na seção Comentários deste tópico.

Versionspec

O valor fornecido pelo usuário para o /version opção. Para obter mais informações sobre como Team Foundation analisa uma especificação de versão para determinar quais itens estão dentro de seu escopo, consulte Sintaxe de linha de comando (controle de versão).

Shelvesetowner

Identifica o proprietário da shelveset pelo nome do usuário. Se um valor para esse parâmetro não for fornecido, presume-se o usuário atual.

Shelvesetname

Especifica o nome de um shelveset. Você pode criar mais de um shelveset com o mesmo nome no servidor que está executando o Team Foundation Server como um usuário diferente é responsável por cada shelveset.

Shelveset_itemspec

Especifica o nome de um arquivo ou pasta em que o shelveset para comparar a versão base shelveset.

username

Fornece um valor para o /login opção. Você pode especificar um valor de username como domínio\nome de usuário ou nome de usuário.

Option

Description

/type

Substitui qualquer codificações detectadas e usa a codificação especificada para apresentar os arquivos para o mecanismo de diferenciação.

/version

Especifica a versão do arquivo ou pasta para comparar. Por padrão, Team Foundation usa a versão de espaço de trabalho, se você não fornecer um versionspec.

Em vez de usar o /version sinalizador, você pode especificar as versões acrescentando um especificador de versão e -e-vírgula ao final de cada nome de arquivo.

/format

Especifica um formato de saída especificado pelo format argumento.

/ignorespace

Não realça as diferenças de espaço em branco entre os arquivos comparados.

/ignoreeol

Ignora as diferenças entre os caracteres de nova linha nas versões de arquivo ou de dois arquivos. /ignoreeolfunciona de modo diferente de /ignoreSpace. /ignorespacetrata os espaços de oito idêntico a um. No entanto, se você usar o /ignoreeol a opção e o arquivo possui dois caracteres de nova linha entre inalterado áreas de texto e b do arquivo possui um, o resultado é exibido como uma diferença. Se ambos os arquivos têm apenas uma linha nova, mas o arquivo a usa \r\n como uma nova linha e o arquivo b usa \n, /ignoreEOL opção seria ignorar que, como uma diferença.

/ignorecase

Não realça as diferenças em maiúsculas de letra entre arquivos comparados.

/recursive

Compara as diferenças entre a pasta atual e todas as suas subpastas.

/options

Especifica uma seqüência de caracteres de opção para a ferramenta de ser invocado por comparação. For more information, see Associar um tipo de arquivo com uma ferramenta de diferença and Associar um tipo de arquivo com uma ferramenta de mesclagem.

/shelveset

Especifica um shelveset para comparar com o Controle de versão do Team Foundation versão do servidor no qual se baseia o shelveset.

Esta opção não pode ser combinada com um itemspec argumento. Para comparar os itens individuais de shelveset, você pode fornecer um shelveset_itemspec.

/noprompt

Suprime as caixas de diálogo que seriam exibidas durante a conclusão desta operação.

/configure

Chama o Configure User Tools caixa de diálogo. Essa ferramenta está disponível a partir de Visual Studio interface do usuário. For more information, see Associar um tipo de arquivo com uma ferramenta de diferença.

/login

Especifica o nome de usuário e senha para autenticar o usuário com Team Foundation Server.

Comentários

ObservaçãoObservação

Você pode digitar tf diff ou tf difference na linha de comando para executar este comando.

Você pode usar o difference comando para comparar e se é possível exibir as diferenças entre:

  • Dois arquivos diferentes ou duas versões do mesmo arquivo.

  • Um ou mais itens em uma pasta.

  • Um, alguns ou todos os itens em um shelveset sobre o Team Foundation Server.

Você pode usar o difference comando para comparar arquivos versionados e sem versão.

Team Foundationcategoriza todos os arquivos por tipo. Arquivos de texto podem ser mesclados e comparados, lado a lado e linha por linha, desde que ambos os arquivos que tenham a mesma codificação. Se você quiser comparar dois arquivos cujas codificações não forem iguais, você pode temporariamente máscara ou substituir a propriedade de codificação para um arquivo usando o /type opção. Arquivos binários podem ser comparados, mas não podem ser mesclados. Quando você passa um ou mais arquivos binários para o comando de diferença, Team Foundation indica se existem diferenças entre ele e o item ao qual está sendo comparado. Para obter mais informações sobre como Team Foundation diferencia e trata os arquivos de diferentes tipos, consulte Gerenciamento de tipos de arquivo.

Se você especificar dois nomes de arquivo, os dois arquivos são comparados. Em vez de usar o /version sinalizador, você pode especificar as versões acrescentando um especificador de versão e -e-vírgula ao final de cada nome de arquivo.

Se você passar apenas um itemspec para o comando de diferença:

  • Se não fornecer um versionspec, sua versão atual do espaço de trabalho do item é comparado com a versão básica do espaço de trabalho, por padrão. Por exemplo, tf difference header.h compara a versão atual do header.h para a versão na qual se baseia o header.h.

  • Se você incluir um versionspec no seu itemspec como, por exemplo, tf difference header.h;LBeta1, Team Foundation compara dessa versão para a sua versão atual do espaço de trabalho no disco.

  • Se você especificar um intervalo de versões, como /version:C1~C4, em comparação com as versões do arquivo em dois pontos de extremidade do intervalo.

Para obter mais informações sobre como localizar o tf o utilitário de linha de comando, consulte Comandos do utilitário de linha de comando do TF.

Tipos de formato de saída

O format parâmetro, usado com o /format opção, especifica muitos formatos de saída diferente. Os tipos de saída disponíveis são

  • Visual

    Visualtipo de formato abre um aplicativo externo de diferença. Por padrão, diffmerge.exe é iniciado.

  • Brief

    O formato breve imprime se os arquivos que estão sendo comparados são diferentes.

  • Context

    Contextformato fornece linhas de contexto para as diferenças nos arquivos. Esse formato é derivado de UNIX com base em diff –c formato de saída.

  • RCS

    RCSformato é semelhante a /format:unix, exceto as linhas de contexto não são fornecidas.

    Não é fornecido nenhum entregando especiais para um fim ausente do marcador de linha no final do arquivo.

  • SS

    SSé o formato de saída de diferença de padrão de Visual SourceSafe. Para obter mais informações, consulte "Diff (linha de comando)" no site da Microsoft (https://go.microsoft.com/fwlink/?LinkId=99139).

  • SS_SideBySide

    SS_SideBySideé o formato de saída de lado a lado padrão para Visual SourceSafe.

  • SS_Unix

    SS_Unix é semelhante ao formato de saída /format:unix, mas /format:ss_unix inclui linhas de contexto e /format:unix não.

  • Unified

    Unifiedformato é derivado de UNIX com base em diff –u formato de saída. /format:contextRepete linhas de contexto idênticos entre as seqüências de caracteres de diferença, embora /format:unified faz não.

    Unifiedformato produz uma nova seqüência de diferença unificada (@ @... linha de @ @) somente quando a distância até a próxima seqüência de diferença for maior que o número de linhas de contexto.

  • Unix

    Esse tipo de saída é derivado de UNIX com base em diff formato de saída do comando.

    O Unix formato de saída é construído da seguinte maneira:

    <metadataline>
    "< " line prefix for lines from the first file
    "---" line
    "> " line prefix for lines from the second file
    
    <metadataline> can be one of these possibilities:
    #a#,# -- add lines from line # in file1 into file2 at lines #->#
    #,#d# -- delete lines from line # -> # in file 1 from file2 at line #
    #,#c#,# -- change lines from line # -> # in file1 into the lines in file2 at line # -> #
    
    # signs seprated by commas indicate a line range.
    # signs before the character indicate line numbers in the first file
    # signs after the character indidicate line numbers in the second file
    
    /// No end of line marker at the end of the file:
    /// \ No newline at end of file
    

Examples

O exemplo a seguir exibe as diferenças entre a versão local do sistema de coordenadas de 314. e a versão de espaço de trabalho do sistema de coordenadas de 314. é a versão do arquivo que foi retirado da Controle de versão do Team Foundation server.

c:\projects>tf difference 314.cs

O exemplo a seguir exibe todos os arquivos que foram alterados na pasta src. Não exibe arquivos que foram alterados em subpastas da src.

c:\projects>tf difference src /format:visual

O exemplo a seguir exibe as diferenças entre changeset 3 e 8 do changeset de 1254.cs.

c:\projects>tf difference /version:C3~C8 1254.cs

Os exemplos seguintes exibem as diferenças entre a versão do sistema de coordenadas de 314. que pertencem ao rótulo "liberar" e a versão que pertence a changeset 3200.

c:\projects>tf difference 314.cs;Lrelease 314.cs;C3200

—or—

c:\projects>tf difference 314.cs;Lrelease~C3200

O exemplo a seguir exibe a diferença entre as versões do e271.cs que um usuário chamado Nadia é arquivado no shelveset PeerCodeReview8 e o shelveset base versão que é a versão na qual ela baseia suas alterações. Também exibe os tipos de alterações pendentes contra e271.cs quando Nadia é arquivado.

c:\projects> tf difference /shelveset:PeerCodeReview8;Nadia e271.cs

O exemplo a seguir exibe as diferenças entre todos os arquivos de shelveset a PeerCodeReview2 e a versão base shelveset desses arquivos.

c:\projects> tf difference /shelveset:PeerCodeReview2

Consulte também

Referência

Comando Mesclar

Comando de check-in

Comando de Shelvesets

Conceitos

Gerenciamento de tipos de arquivo

Outros recursos

Comandos do utilitário de linha de comando do TF

Comparando os arquivos e pastas