Delen via

Opdracht Verschil

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

De TfVC-opdracht (Team Foundation Version Control) difference vergelijkt en indien mogelijk worden weergegeven, verschillen tussen twee bestanden, bestanden in twee mappen of een plankenset en een lokaal of serverbestand.

Voorwaarden

Als u de opdracht difference wilt gebruiken, moet u de machtiging Lezen voor alle opgegeven items instellen op toestaan. Zie standaard TFVC-machtigingenvoor meer informatie.

Syntaxis

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

Parameters

Argumenten

argument

beschrijving

<itemspec>

Vereist. Hiermee geeft u het te vergelijken item. Als er geen versie of pad is opgegeven, wordt uitgegaan van de huidige werkruimteversie. Accepteert zowel lokale als Azure DevOps-serverpaden.

Zie Team Foundation-versiebeheeropdrachtengebruiken voor meer informatie over hoe TFVC de itemspec parseert om te bepalen welke items binnen het bereik vallen.

De opdracht difference biedt geen ondersteuning voor jokertekens.

Deze parameter kan niet worden gecombineerd met de optie /shelveset.

<itemspec2>

Facultatief. Het item waarop de itemspec moet worden vergeleken. Als u geen tweede itemspecopgeeft, wordt de meest recente versie van de Azure DevOps-server van het item gebruikt.

<filetype>

Biedt een waarde voor de optie /type. U kunt binary of text en een codepaginanummer of de beschrijvende naam voor een codepagina opgeven.

<format>

Wordt gebruikt met de optie /format om een uitvoerindeling van een van de volgende typen op te geven:

  • Visual
  • Brief
  • Context
  • RCS
  • SS
  • SS_SideBySide
  • SS_Unix
  • Unified
  • Unix

Deze uitvoerindelingen worden uitgelegd in de sectie Opmerkingen.

<versionspec>

De door de gebruiker opgegeven waarde voor de optie /version. Zie Team Foundation-versiebeheeropdrachten gebruikenvoor meer informatie over hoe TFVC een versiespecificatie parseert om te bepalen welke items binnen het bereik vallen.

<shelvesetowner>

Identificeert de eigenaar van de plankenset op gebruikersnaam. Als er geen waarde voor deze parameter wordt opgegeven, wordt ervan uitgegaan dat de huidige gebruiker.

<shelvesetname>

Hiermee geeft u de naam van een plankenset. U kunt meer dan één plankenset maken met dezelfde naam op de server waarop TFVC wordt uitgevoerd, zolang een andere gebruiker eigenaar is van elke plankenset.

<shelveset_itemspec>

Hiermee geeft u de naam van een map of bestand in de plankenset om te vergelijken met de basis plankensetversie.

<username>

Biedt een waarde voor de optie /login. U kunt een gebruikersnaamwaarde opgeven als DOMAIN\username of username.

Opties

optie

beschrijving

/type

Hiermee overschrijft u alle gedetecteerde coderingen en gebruikt u de opgegeven codering om de bestanden aan de differentiërende engine te presenteren.

/version

Hiermee geeft u de versie van het bestand of de map te vergelijken. TFVC gebruikt standaard de werkruimteversie als u geen versionspecopgeeft.

In plaats van de vlag /version te gebruiken, kunt u versies opgeven door een puntkomma en versieaanduiding toe te voegen aan het einde van elke bestandsnaam.

/format

Hiermee geeft u een uitvoerindeling op die is opgegeven door het argument format.

/ignorespace

Markeert geen witruimteverschillen tussen de vergeleken bestanden.

/ignoreeol

Negeert verschillen tussen de nieuwe regeltekens in twee bestanden of bestandsversies. /ignoreeol werkt anders dan ignorespace, waarbij acht spaties identiek aan één worden behandeld. Als u echter de optie /ignoreeol gebruikt en bestand A- twee nieuwe regeltekens bevat tussen ongewijzigde tekstgebieden en bestand B één heeft, wordt het resultaat weergegeven als een verschil. Als beide bestanden slechts één nieuwe regel hebben, maar bestand A\r\n gebruikt als een nieuwe regel en bestand B\ngebruikt, wordt dat als verschil genegeerd door de /ignoreeol optie.

/ignorecase

Markeert geen verschillen in letterbehuizing tussen de vergeleken bestanden.

/recursive

Vergelijkt de verschillen tussen de huidige map en alle bijbehorende submappen.

/options

Hiermee geeft u een optietekenreeks op voor het hulpprogramma dat moet worden aangeroepen door difference. Zie Een bestandstype koppelen aan een verschilhulpmiddel en Een bestandstype koppelen aan een samenvoegprogrammavoor meer informatie.

/shelveset

Hiermee geeft u een plankenset op die moet worden vergeleken met de Azure DevOps-serverversie waarop de plankenset is gebaseerd.

Deze optie kan niet worden gecombineerd met een itemspec argument. Als u afzonderlijke plankensetitems wilt vergelijken, kunt u een shelveset_itemspec.

/noprompt

Onderdrukt dialoogvensters die anders zouden worden weergegeven tijdens het voltooien van deze bewerking.

/configure

Hiermee wordt het dialoogvenster Gebruikershulpprogramma's configureren vanuit de Visual Studio-gebruikersinterface aangeroepen. Zie Een bestandstype koppelen aan een verschilhulpmiddelvoor meer informatie.

/login

Hiermee geeft u de gebruikersnaam en het wachtwoord op om de gebruiker te verifiëren met TFVC.

Opmerkingen

Notitie

U kunt tf diff of tf difference typen op de opdrachtregel om deze opdracht uit te voeren.

U kunt de opdracht difference gebruiken om verschillen tussen de volgende opties te vergelijken en indien mogelijk weer te geven:

  • Twee verschillende bestanden of twee versies van hetzelfde bestand.

  • Een of meer items in een map.

  • Een, sommige of alle items in een plankenset op de Azure DevOps-server.

U kunt de opdracht difference gebruiken om zowel versie- als niet-versiebestanden te vergelijken.

TFVC categoriseert alle bestanden per type. Tekstbestanden kunnen worden samengevoegd en vergeleken, naast elkaar en per regel, zolang beide bestanden dezelfde codering hebben. Als u twee bestanden wilt vergelijken waarvan de coderingen niet hetzelfde zijn, kunt u de coderingseigenschap voor een bestand tijdelijk maskeren of overschrijven met behulp van de optie /type.

Binaire bestanden kunnen worden vergeleken, maar kunnen niet worden samengevoegd. Wanneer u een of meer binaire bestanden doorgeeft aan de opdracht difference, geeft TFVC aan of er verschillen bestaan tussen het bestand en het item waarmee het wordt vergeleken. Zie Bestandstypen beherenvoor meer informatie over hoe TFVC onderscheid maakt tussen en behandelt bestanden van verschillende typen.

Als u twee bestandsnamen opgeeft, worden de twee bestanden vergeleken. In plaats van de vlag /version te gebruiken, kunt u versies opgeven door een puntkomma en versieaanduiding toe te voegen aan het einde van elke bestandsnaam.

Als u slechts één itemspec doorgeeft aan de opdracht verschil:

  • Als u geen versionspecopgeeft, wordt de huidige werkruimteversie van het item standaard vergeleken met de basiswerkruimteversie. tf difference header.h vergelijkt bijvoorbeeld de huidige versie van header.h met de versie waarop header.h is gebaseerd.

  • Als u een versionspec opneemt in uw itemspec, zoals tf difference header.h;LBeta1, vergelijkt TFVC die versie met uw huidige werkruimteversie op schijf.

  • Als u een reeks versies opgeeft, zoals /version:C1~C4, worden de versies van het bestand op de twee eindpunten van het bereik vergeleken.

Zie Team Foundation-versiebeheeropdrachten gebruikenvoor meer informatie over het gebruik van het opdrachtregelprogramma tf.

Typen uitvoerindelingen

De parameter format, die wordt gebruikt met de optie /format, geeft veel verschillende uitvoerindelingen op. De volgende uitvoertypen zijn beschikbaar:

  • Visual indelingstype wordt een externe verschiltoepassing geopend. Standaard wordt diffmerge.exe gestart.

  • Brief formaat wordt afgedrukt of de bestanden die worden vergeleken verschillen.

  • Context-indeling biedt regels context voor de verschillen in de bestanden. Deze indeling is afgeleid van de op UNIX gebaseerde diff -c uitvoerindeling.

  • RCS-indeling is vergelijkbaar met /format:unix, behalve dat er geen contextlijnen worden opgegeven. Er is geen speciale handing voor een ontbrekend einde van de lijnmarkering aan het einde van het bestand opgegeven.

  • SS is de standaardverschiluitvoerindeling voor Visual SourceSafe. Zie Diff (opdrachtregel)voor meer informatie.

  • SS_SideBySide is de standaarduitvoerindeling naast elkaar voor Visual SourceSafe.

  • SS_Unix lijkt op de /format:unix uitvoerindeling, maar /format:ss_unix bevat contextlijnen en /format:unix niet.

  • Unified-indeling is afgeleid van de uitvoerindeling op basis van UNIX diff -u. /format:context herhaalt identieke contextlijnen tussen de verschiltekenreeksen, maar /format:unified niet.

    Unified-indeling produceert alleen een nieuwe uniforme verschiltekenreeks (@@ ... @@) wanneer de afstand tot de volgende verschiltekenreeks groter is dan het aantal contextlijnen.

  • Unix uitvoertype is afgeleid van de uitvoerindeling van unix diff opdracht.

    De Unix uitvoerindeling wordt op de volgende manier samengesteld:

    <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 separated by commas indicate a line range.
# signs before the character indicate line numbers in the first file.
# signs after the character indicate line numbers in the second file.

/// No end of line marker at the end of the file:
/// \ No newline at end of file

Voorbeelden

In het volgende voorbeeld ziet u de verschillen tussen de lokale versie van 314.cs en de werkruimteversie van 314.cs die de versie is van het bestand dat is uitgecheckt vanaf de Azure DevOps-server.

c:\projects>tf difference 314.cs

In het volgende voorbeeld worden alle bestanden weergegeven die zijn gewijzigd in de map src, maar worden geen bestanden weergegeven die zijn gewijzigd in submappen van src-.

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

In het volgende voorbeeld worden de verschillen tussen wijzigingenset 3 en wijzigingenset 8 van 1254.csweergegeven.

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

In de volgende voorbeelden worden de verschillen weergegeven tussen de versie van 314.cs die deel uitmaken van het label release en de versie die deel uitmaakt van de wijzigingenset 3200.

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

-of-

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

In het volgende voorbeeld ziet u het verschil tussen de versies van e271.cs dat een gebruiker met de naam Pat in plankenset PeerCodeReview8 en de basisversie van de plankenset waarop ze hun wijzigingen hebben gebaseerd. In de uitvoer ziet u ook de typen wijzigingen die in behandeling zijn voor e271.cs wanneer de gebruiker op de plank staat.

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

In het volgende voorbeeld ziet u de verschillen tussen alle bestanden in de PeerCodeReview2 plankenset en de basis-plankensetversie van die bestanden.

c:\projects> tf difference /shelveset:PeerCodeReview2