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:
|
/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
Konzepte
Team Foundation-Auscheckeinstellungen