Checkout et Edit, commandes
Rend le fichier local accessible en écriture et modifie son état modification en attente sur « modifier » dans l'espace de travail. Edit est un alias pour la commande Checkout. Pour plus d'informations, consultez Modifications en attente.
Notes
Toutes les modifications que vous effectuez sur des éléments extraits ne sont répercutées dans le serveur de contrôle de version Team Foundation qu'après une opération d'archivage. Pour plus d'informations, consultez Archiver des modifications en attente.
Autorisations requises
Pour utiliser la commande checkout, vous devez disposer de l'autorisation Extraire avec la valeur Autoriser et vous devez être le propriétaire de l'espace de travail ou disposer de l'autorisation Administrer les espaces de travail avec la valeur Autoriser. De plus, si vous utilisez l'option /lock avec une valeur autre que Aucun, l'autorisation Verrouiller doit avoir la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
tf checkout [/lock:(none|checkin|checkout)] [/recursive]
[/type:encoding] itemspec [/login:username,[password]]
Paramètres
Argument |
Description |
|---|---|
encoding |
Fournit une valeur pour l'option /type. Les alternatives sont les suivantes : Text est un alias pour l'encodage Windows actuel (Windows-1252 sur les systèmes américains) ou Unicode (basé sur la BOM ou la marque d'ordre des octets), Binary et tous les autres codages de fichier pris en charge par le système d'exploitation Windows. Vous pouvez également utiliser l'option Auto qui détecte le type pour vous. Pour plus d'informations, consultez Gestion des types de fichiers. |
itemspec |
Spécifie un ou plusieurs fichiers à extraire. Vous pouvez utiliser des caractères génériques. |
username |
Fournit une valeur pour l'option /login. Vous pouvez spécifier une valeur de nom d'utilisateur comme DOMAINE\NomUtilisateur ou NomUtilisateur. |
Option |
Description |
|---|---|
/type |
Substitue manuellement l'encodage de fichier qui associe Team Foundation aux fichiers spécifiés. |
/recursive |
Extrait tous les fichiers qui correspondent à la spécification d'éléments (itemspec) dans le répertoire actif ou et tous ses sous-dossiers. |
/lock |
Empêche d'autres utilisateurs d'archiver ou d'extraire les fichiers spécifiés. Pour plus d'informations, consultez Présentation des types de verrous. Options de verrouillage :
|
/login |
Spécifie le nom d'utilisateur et le mot de passe pour authentifier l'utilisateur avec Visual Studio Team Foundation Server. |
Notes
Le comportement par défaut de la commande checkout est déterminé par l'activation ou non du paramètre Obtenir la dernière version de l'élément lors de l'extraction. Pour plus d'informations sur l'affichage ou la modification de ce paramètre, consultez Activer le contrôle de version Team Foundation pour obtenir les fichiers les plus récents lors de l'extraction.
Si le paramètre Obtenir la dernière version de l'élément lors de l'extraction est activé, le comportement de la commande checkout ressemble au comportement d'extraction dans Visual SourceSafe. Si la version la plus récente de l'élément ne se trouve pas dans votre espace de travail, Team Foundation obtient la version la plus récente de Team Foundation Server et la copie dans votre espace de travail. Si une version antérieure du même élément se trouve dans votre espace de travail, il est remplacé par la version la plus récente.
Si le paramètre Obtenir la dernière version de l'élément lors de l'extraction est désactivé, Team Foundation n'obtient pas la version la plus récente de contrôle de version Team Foundation pendant une opération d'extraction. Au lieu de cela, il rend la version actuelle de l'espace de travail accessible en écriture. Pour plus d'informations, consultez Obtenir la source de votre projet d'équipe.
Vous pouvez utiliser tf edit comme un alias de checkout.
Par défaut, plusieurs utilisateurs peuvent extraire en même temps le même élément sous contrôle de version. Lorsque vous utilisez tf pour extraire un élément ayant des modifications en attente dans un autre espace de travail, des informations sur la nature de ces autres modifications s'affichent sur la ligne de commande. Dans la plupart des environnements de développement collaboratifs, il est peu probable que vous apportiez dans votre espace de travail une modification qui représente un conflit de fusion potentiel avec une modification en attente dans un autre espace de travail ou vice versa. Team Foundation vous permet de résoudre automatiquement la plupart des conflits qui se produisent. Pour les conflits qui ne peuvent pas être résolus automatiquement, utilisez la Resolve, commande pour décider en toute sécurité quelle modification (la vôtre ou celles initialisées par d'autres utilisateurs) vous souhaitez conserver. Si vous craignez qu'un autre utilisateur n'effectue dans son espace de travail des modifications qui entrent en conflit avec vos modifications en attente, vous pouvez utiliser la Status, commande pour surveiller les modifications récentes intervenues dans les autres espaces de travail. Vous pouvez également utiliser la Lock, commande pour empêcher d'autres utilisateurs d'extraire ou d'archiver quoi que ce soit tant que vous n'avez pas archivé et déverrouillé vos propres modifications. La meilleure pratique consiste à manipuler la commande lock avec précaution et à notifier à vos coéquipiers pourquoi vous l'utilisez et quand vous projetez de supprimer le verrou.
Pour plus d'informations sur la localisation de l'utilitaire en ligne de commande tf, consultez Commandes de l'utilitaire en ligne de commande Tf.
Exemples
L'exemple suivant rend 314.cs accessible en écriture sur le disque et l'ajoute à la liste des modifications en attente pour l'espace de travail.
c:\pi> tf checkout 314.cs
L'exemple suivant extrait à la fois 314.cs et 271.cs.
c:\pi>tf checkout 314.cs 271.cs
L'exemple suivant extrait page.xsl et modifie la propriété d'encodage du type de fichier Team Foundation pour lui attribuer la valeur texte. Le texte est un alias pour l'encodage Windows actuel, tel que Windows-1252.
c:\pi>tf checkout /type:text page.xsl
Voir aussi
Tâches
Extraire et modifier les éléments sous contrôle de version
Référence
Concepts
Présentation des types de verrous
Paramètres d'extraction de Team Foundation