Difference-Befehl

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

Visual Studio 2019 | Visual Studio 2022

Mit dem Befehl difference der Team Foundation-Versionskontrolle (TFVC) werden Unterschiede zwischen zwei Dateien, Dateien in zwei Ordnern oder einem Shelveset und einer lokalen oder einer Serverdatei verglichen und nach Möglichkeit angezeigt.

Voraussetzungen

Zum Verwenden des Befehls difference muss die Berechtigung Lesen für alle angegebenen Elemente auf Zulassen festgelegt sein. Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.

Syntax

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

Parameter

Argumente

Tastatur

Bemerkungen

Sie können den difference-Befehl für den Vergleich von Unterschieden und nach Möglichkeit deren Anzeige zwischen folgenden Elementen verwenden:

• Zwei verschiedenen Dateien oder zwei Versionen derselben Datei

• Einem oder mehreren Element(en) in einem Ordner.

• Einem, mehreren oder allen Element(en) in einem Shelveset auf dem Azure DevOps-Server.

Sie können den difference-Befehl für den Vergleich sowohl von Dateien mit als auch ohne Versionsverwaltung zu verwenden.

TFVC kategorisiert alle Dateien nach Typ. Textdateien können zusammengeführt und verglichen werden, nebeneinander und Zeile für Zeile, solange beide Dateien die gleiche Codierung aufweisen. Wenn Sie zwei Dateien vergleichen möchten, deren Codierungen nicht identisch sind, können Sie die Codierungseigenschaft für eine Datei mithilfe der Option /type vorübergehend maskieren oder außer Kraft setzen.

Binärdateien können verglichen, aber nicht zusammengeführt werden. Wenn Sie dem difference-Befehl eine oder mehrere Binärdateien übergeben, gibt TFVC an, ob Unterschiede zwischen ihnen und dem Vergleichselement bestehen. Weitere Informationen dazu, wie TFVC zwischen Dateien unterscheidet und Dateien verschiedener Typen behandelt, finden Sie unter Verwalten von Dateitypen.

Wenn Sie zwei Dateinamen angeben, werden die beiden Dateien verglichen. Anstatt das /version-Flag zu verwenden, können Sie Versionen angeben, indem Sie ein Semikolon und einen Versionsbezeichner an das Ende jedes Dateinamens anfügen.

Wenn Sie dem Differenzbefehl nur eine itemspec übergeben:

• Wenn Sie keine versionspec angeben, wird Ihre aktuelle Arbeitsbereichsversion des Elements standardmäßig mit der Basisarbeitsbereichsversion verglichen. Beispielsweise vergleicht tf difference header.h die aktuelle Version von header.h mit der Version, auf der header.h basiert.

• Wenn Sie eine versionspec in Ihre itemspec einschließen, wie etwa tf difference header.h;LBeta1, vergleicht TFVC diese Version mit Ihrer aktuellen Arbeitsbereichsversion auf dem Datenträger.

• Wenn Sie einen Bereich von Versionen wie /version:C1~C4 angeben, werden die Versionen der Datei an den beiden Endpunkten des Bereichs verglichen.

Weitere Informationen zur Verwendung des Befehlszeilenhilfsprogramms tf finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

Ausgabeformattypen

Der format-Parameter gibt in Verbindung mit der Option /format viele verschiedene Ausgabeformate an. Die folgenden Ausgabetypen sind verfügbar:

• Der Formattyp Visual öffnet eine externe Differenzanwendung. Standardmäßig wird diffmerge.exe gestartet.

• Das Brief-Format gibt an, ob sich die verglichenen Dateien unterscheiden.

• Das Context-Format stellt Kontextzeilen für die Unterschiede in den Dateien zur Verfügung. Dieses Format ist vom UNIX-basierten Ausgabeformat diff -c abgeleitet.

• Das Format RCS ist ähnlich wie /format:unix, mit dem Unterschied, dass keine Kontextzeilen angegeben werden. Es gibt keine besondere Behandlung für den Fall einer fehlenden Zeilenendemarkierung am Dateiende.

• SS ist das Standardformat für die Abweichungsausgabe für Visual SourceSafe. Weitere Informationen finden Sie unter Diff (Befehlszeile).

• SS_SideBySide ist das standardmäßige parallele Ausgabeformat für Visual SourceSafe.

• SS_Unix ist dem Ausgabeformat /format:unix ähnlich, jedoch enthält /format:ss_unix Kontextzeilen, /format:unix dagegen nicht.

• Das Format Unified ist vom UNIX-basierten Ausgabeformat diff -u abgeleitet. /format:context wiederholt identische Kontextzeilen zwischen den Differenzzeichenfolgen, /format:unified jedoch nicht.

  Das Format Unified erzeugt nur dann eine neue einheitliche Differenzzeichenfolgenzeile (@@ ... @@), wenn der Abstand zur nächsten Differenzzeichenfolge größer als die Anzahl der Kontextzeilen ist.

• Der Ausgabetyp Unix ist vom UNIX-basierten Ausgabeformat des diff-Befehls abgeleitet.

  Das Unix-Ausgabeformat ist folgendermaßen aufgebaut:

  <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
  

Beispiele

Im folgenden Beispiel werden die Unterschiede zwischen der lokalen Version von 314.cs und der Arbeitsbereichsversion von 314.cs angezeigt, bei der es sich um die Version der Datei handelt, die vom Azure DevOps-Server ausgecheckt wurde.

c:\projects>tf difference 314.cs

Im folgenden Beispiel werden alle geänderten Dateien im Ordner src angezeigt, aber keine geänderten Dateien in Unterordnern von src.

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

Im folgenden Beispiel werden die Unterschiede zwischen Changeset 3 und Changeset 8 von 1254.cs angezeigt.

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

Die folgenden Beispiele zeigen die Unterschiede zwischen der Version von 314.cs an, die zur Bezeichnung release gehört, und der Version, die zu Changeset 3200 gehört.

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

Oder

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

Im folgenden Beispiel wird der Unterschied zwischen den Versionen von e271.cs angezeigt, die ein Benutzer namens Pat im Shelveset PeerCodeReview8 gespeichert hat, und der Basisversion des Shelvesets, auf der seine Änderungen basieren. Die Ausgabe zeigt außerdem die Typen von Änderungen an, die in Vergleich zu e271.cs beim Shelven des Benutzers ausgestanden haben.

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

Im folgenden Beispiel werden die Unterschiede zwischen allen Dateien im Shelveset PeerCodeReview2 und der Basisversion dieser Dateien angezeigt.

c:\projects> tf difference /shelveset:PeerCodeReview2

Verwandte Artikel

• Merge-Befehl
• Befehl Checkin
• Shelvesets-Befehl
• Verwalten von Dateitypen
• Vergleichen von Ordnern und Dateien