Befehle Check-out und Edit
Hebt den Schreibschutz der lokalen Datei auf und ändert ihren Status im Arbeitsbereich von Anstehende Änderung zu "Bearbeiten". Edit ist ein Alias für den Checkout-Befehl.
Hinweis
Die an ausgecheckten Elementen vorgenommenen Bearbeitungen werden auf dem Server für die Quellcodeverwaltung in Team Foundation erst nach dem Einchecken widergespiegelt. Weitere Informationen finden Sie unter Gewusst wie: Einchecken von ausstehenden Änderungen.
tf checkout [/lock:(none|checkin|checkout)] [/recursive]
[/type:encoding] itemspec
Parameter
| Argument | Beschreibung |
|---|---|
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. Mit Auto können Sie den Typ ermitteln. Weitere Informationen finden Sie unter Dateitypen. |
itemspec |
Gibt eine oder mehrere Dateien für das Auschecken an. Die Verwendung von Platzhalterzeichen wird unterstützt. |
| Option | Beschreibung |
|---|---|
/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 am angegebenen Speicherort sowie in den Unterordnern entsprechen. |
/lock |
Verhindert, dass andere Benutzer die angegebenen Dateien ein- oder auschecken. Weitere Informationen finden Sie unter Grundlagen von Sperrentypen. Sperroptionen:
|
Hinweise
Bevor Sie ein Element auschecken können, müssen Sie es auf dem Server für die Quellcodeverwaltung in Team Foundation hinzufügen. Weitere Informationen über das Einrichten eines lokalen Arbeitsbereichs und das Hinzufügen von Elementen zur Quellcodeverwaltung finden Sie unter Exemplarische Vorgehensweise: Arbeiten mit der Team Foundation-Quellcodeverwaltung über die Befehlszeile.
Im Gegensatz zu anderen Quellcodeverwaltungssystemen ruft Team Foundation während eines Auscheckvorgangs nicht die letzte Version auf dem Server für die Quellcodeverwaltung in Team Foundation ab. Stattdessen hebt es den Schreibschutz der aktuellen Arbeitsbereichsversion auf. Weitere Informationen finden Sie unter Gewusst wie: Abrufen der Quellcodeverwaltung für das Teamprojekt.
Sie können tf edit als Alias für checkout verwenden.
Standardmäßig können mehrere Benutzer dasselbe Element unter Quellcodeverwaltung gleichzeitig auschecken. Wenn Sie tf für das Auschecken eines Elements mit ausstehenden Änderungen in einem anderen Arbeitsbereich auschecken, werden in der Befehlszeile Informationen über die Art der Änderungen ausgegeben. In den meisten gemeinsamen Entwicklungsumgebungen ist die Wahrscheinlichkeit, dass eine Änderungen in einem Arbeitsbereich zu einem Zusammenführungskonflikt mit einer ausstehenden Änderung in einem anderen Arbeitsbereich führt, sehr gering. Die meisten auftretenden Konflikte können von Team Foundation automatisch gelöst werden. Bei Konflikten, die nicht automatisch gelöst werden können, können Sie mit Befehl Resolve auf sichere Weise entscheiden, welche Änderung Sie beibehalten möchten. Wenn Sie verhindern möchten, dass Benutzer in ihren Arbeitsbereichen Änderungen vornehmen können, die evtl. 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 hierfür sowie über den geplanten Zeitpunkt des Entsperrens zu informieren.
Beispiele
In den folgenden Beispielen ist das aktuelle Verzeichnis ein Arbeitsordner im Arbeitsbereich "Math".
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 Math 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 auf den angegebenen Wert geändert. Text ist ein Alias für die aktuelle Windows-Codierung, z. B. Windows-1252.
c:\pi>tf checkout /type:text page.xsl
Sicherheit
Zum Verwenden des checkout-Befehls muss die Auschecken-Berechtigung auf Zulassen festgelegt sein, und Sie müssen entweder Besitzer des Arbeitsbereichs sein oder die globale Arbeitsbereiche verwalten-Berechtigung muss auf Zulassen festgelegt sein. Wenn die Option /lock mit einem Wert verwendet wird, der nicht NONE ist, muss außerdem die Sperren-Berechtigung auf Zulassen festgelegt sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.
Siehe auch
Aufgaben
Exemplarische Vorgehensweise: Arbeiten mit der Team Foundation-Quellcodeverwaltung über die Befehlszeile
Gewusst wie: Auschecken und Bearbeiten von Elementen unter Quellcodeverwaltung
Referenz
Befehl Get
Befehl Checkin
Befehl Unshelve