Freigeben über


Befehle Checkout und Edit

Sorgt dafür, dass die lokale Datei schreibbar gemacht wird und ändert den Status im Arbeitsbereich für ausstehende Änderung in "Bearbeiten". Edit ist ein Alias für den Befehl Checkout. Weitere Informationen finden Sie in Ausstehende Änderungen.

Tipp

   Die an ausgecheckten Elementen vorgenommenen Bearbeitungen werden auf dem Server für die Team Foundation-Versionskontrolle erst nach dem Einchecken widergespiegelt. Weitere Informationen finden Sie unter Einchecken von ausstehenden Änderungen.

Erforderliche Berechtigungen

Um den Befehl checkout verwenden zu können, muss Ihre Auschecken-Berechtigung auf Zulassen festgelegt sein, und Sie müssen entweder der Besitzer des Arbeitsbereichs sein, oder die globale Arbeitsbereiche verwalten-Berechtigung muss auf Zulassen festgelegt sein. Wenn Sie darüber hinaus für die Option /lock einen anderen Wert als none angeben, muss die Sperren-Berechtigung auf Zulassen festgelegt sein. Weitere Informationen hierzu finden Sie unter Team Foundation Server-Berechtigungen.

tf checkout [/lock:(none|checkin|checkout)] [/recursive] 

[/type:encoding] itemspec [/login:username,[password]]

Parameter

Argument

Beschreibungen

encoding

Gibt einen Wert für die /type-Option an. Es bestehen folgende Alternativen: Text ist ein Alias für die aktuelle Windows-Codierung (Windows-1252 auf US-amerikanischen Systemen) oder Unicode (auf Grundlage der BOM oder Byte-Reihenfolgemarkierung), Binary und alle anderen Dateicodierungen, die vom Windows-Betriebssystem unterstützt werden. Sie können auch Auto verwenden, um den Typ zu ermitteln. Weitere Informationen finden Sie unter Verwalten von Dateitypen.

itemspec

Gibt eine oder mehrere Dateien für das Auschecken an. Sie können hier Platzhalterzeichen verwenden.

username

Gibt einen Wert für die /login-Option an. Sie können als Wert für einen Benutzernamen entweder DOMÄNE\Benutzername oder Benutzername angeben.

Option

Beschreibungen

/type

Überschreibt manuell die Dateicodierung, die dieser Team Foundation den angegebenen Dateien zuordnet.

/recursive

Checkt alle Dateien aus, die der itemspec im aktuellen Verzeichnis oder in allen Unterordnern des aktuellen Verzeichnisses entsprechen.

/lock

Verhindert, dass andere Benutzer die angegebenen Dateien ein- oder auschecken. Weitere Informationen finden Sie unter Grundlagen von Sperrentypen.

Sperroptionen:

  • None

    Standard. Es wird keine Sperre angewendet. Wenn die angegebene Datei gesperrt ist, kann die Sperre mit None aufgehoben werden.

  • Checkin

    Andere Benutzer können die angegebenen Elemente auschecken, sie können Revisionen gesperrter Dateien jedoch erst dann einchecken, wenn Sie die Sperre wieder aufheben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, schlägt der Sperrvorgang fehl.

  • Checkout

    Verhindert das Auschecken der angegebenen Elemente durch Benutzer, bis Sie die Sperre aufheben. Wenn andere Benutzer eines der angegebenen Elemente gesperrt haben, schlägt der Sperrvorgang fehl.

/login

Gibt den Benutzernamen und das Kennwort für die Benutzerauthentifizierung bei Visual Studio Team Foundation Server an.

Hinweise

Das standardmäßige Verhalten des Befehls checkout hängt davon ab, ob die Einstellung Letzte Version eines Elements beim Auschecken abrufen aktiviert ist. Informationen zum Anzeigen oder Ändern dieser Einstellung finden Sie unter Aktivieren von Team Foundation-Versionskontrolle, um die neuesten Dateien beim Auschecken abzurufen.

Wenn Letzte Version eines Elements beim Auschecken abrufen aktiviert ist, ist das Verhalten des Befehls checkout vergleichbar mit dem Checkoutverhalten in Visual SourceSafe. Wenn die letzte Version des Elements nicht im Arbeitsbereich enthalten ist, ruft Team Foundation die letzte Serverversion von Team Foundation Server ab und kopiert diese in den Arbeitsbereich. Wenn eine ältere Version desselben Elements im Arbeitsbereich enthalten ist, wird diese durch die letzte Version überschrieben.

Wenn Letzte Version eines Elements beim Auschecken abrufen deaktiviert ist, ruft Team Foundation während eines Auscheckvorgangs nicht die letzte Serverversion für die Team Foundation-Versionskontrolle ab. Stattdessen hebt es den Schreibschutz der aktuellen Arbeitsbereichsversion auf. Weitere Informationen finden Sie unter Abrufen der Quelle für das Teamprojekt.

Sie können tf edit als Alias für checkout verwenden.

Standardmäßig können mehrere Benutzer dasselbe Element, das der Versionskontrolle unterliegt, gleichzeitig auschecken. Wenn Sie tf für das Auschecken eines Elements mit ausstehenden Änderungen in einen anderem Arbeitsbereich verwenden, werden in der Befehlszeile Informationen über die Art dieser Änderungen ausgegeben. In den meisten gemeinsamen Entwicklungsumgebungen ist es unwahrscheinlich, dass eine Änderung in einem Arbeitsbereich zu einem Zusammenführungskonflikt mit einer ausstehenden Änderung in einem anderen Arbeitsbereich oder umgekehrt führt. Mit Team Foundation können Sie die meisten Konflikte, die auftreten, automatisch lösen. Für die Konflikte, die nicht automatisch gelöst werden können, können Sie Befehl Resolve verwenden, um auf sichere Weise zu entscheiden, ob Ihre oder die von anderen Benutzern initiierte Änderung beibehalten werden soll. Wenn Sie verhindern möchten, dass Benutzer in ihren Arbeitsbereichen Änderungen vornehmen können, die möglicherweise zu Konflikten mit Ihren ausstehenden Änderungen führen, können Sie mit Befehl Status andere Arbeitsbereiche auf neu angewendete Änderungen überwachen. Sie können auch mit Befehl Lock verhindern, dass andere Benutzer Aus- oder Eincheckvorgänge durchführen, bevor Sie Ihre eigenen Änderungen eingecheckt und entsperrt haben. Es wird empfohlen, den Befehl lock umsichtig zu verwenden und Teammitglieder über den Grund dafür sowie über den geplanten Zeitpunkt des Entsperrens zu informieren.

Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilenhilfsprogramms "Tf".

Beispiele

Im folgenden Beispiel wird der Schreibschutz von 314.cs auf dem Datenträger aufgehoben, und die Datei wird zur Liste der ausstehenden Änderungen für den Arbeitsbereich hinzugefügt.

c:\pi> tf checkout 314.cs

Im folgenden Beispiel werden 314.cs und 271.cs ausgecheckt.

c:\pi>tf checkout 314.cs 271.cs

Im folgenden Beispiel wird page.xsl ausgecheckt, und die Codierungseigenschaft für den Team Foundation-Dateityp in Text geändert. Text ist ein Alias für die aktuelle Windows-Codierung, z. B. Windows-1252.

c:\pi>tf checkout /type:text page.xsl

Siehe auch

Aufgaben

Auschecken und Bearbeiten von Elementen, die der Versionskontrolle unterliegen

Referenz

Befehl Get

Befehl Checkin

Befehl Unshelve

Konzepte

Grundlagen von Sperrentypen

Team Foundation-Auscheckeinstellungen

Weitere Ressourcen

Befehle des Befehlszeilenhilfsprogramms "Tf"