Verrouillage des éléments sous contrôle de version pour empêcher l'apport de modifications

Vous pouvez utiliser la commande de verrouillage pour empêcher temporairement que des modifications soient apportées à un fichier ou un dossier particulier dans le serveur de contrôle de code source. Cette commande peut être utile si vous souhaitez modifier un élément dans votre espace de travail, puis l'archiver sans être obligé de résoudre les conflits de fusion. Un seul utilisateur à la fois peut maintenir un verrouillage sur un fichier ou un dossier particulier. Si vous souhaitez empêcher définitivement l'accès à un élément, vous devez plutôt utiliser la commande d'autorisation.

Dans cette rubrique

• Fonctionnement des verrous

• Verrouiller des dossiers ou des fichiers

• Déverrouiller des dossiers ou des fichiers

Autorisations requises

Pour exécuter ces procédures, vous devez disposer de l'autorisation Verrouiller avec la valeur Autoriser. Pour plus d'informations, consultez la rubrique suivante sur le site Web Microsoft : Autorisations Team Foundation Server.

Fonctionnement des verrous

Vous pouvez spécifier deux types de verrous pour les éléments sous contrôle de version :

• Verrou d'archivage : un verrou d'archivage est moins restrictif qu'un verrou d'extraction. Si vous appliquez un verrou d'archivage, les utilisateurs peuvent continuer à apporter des modifications locales à l'élément dans d'autres espaces de travail. Toutefois, ces modifications ne peuvent pas être archivées tant que vous n'avez pas supprimé le verrou d'archivage ou archivé vos modifications.

• Verrou d'extraction : un verrou d'extraction, plus restrictif qu'un verrou d'archivage, empêche les utilisateurs d'extraire et de modifier l'élément verrouillé dans leurs espaces de travail. Vous ne pouvez pas appliquer de verrou d'extraction à un élément présentant des modifications en attente, ou situé dans un espace de travail autre que le vôtre. Par conséquent, un verrou d'archivage ou d'extraction garantit au détenteur d'un verrou, dans l'espace de travail où ce verrou s'applique, le droit d'archiver en premier les modifications.

Comment fonctionne le verrouillage

Si un fichier est extrait lorsque vous le verrouillez, son enregistrement d'extraction est modifié pour contenir le nouveau type de verrou. Si le fichier n'est pas extrait, une modification de " verrouillage " est ajoutée au jeu de modifications de l'espace de travail en attente. Contrairement à la commande d'extraction, la commande de verrouillage ne rend pas automatiquement un fichier modifiable.

Si vous extrayez un fichier qui est d'un type traité comme un fichier binaire, Visual Studio Team Foundation Server peut le verrouiller automatiquement parce que les fichiers binaires ne peuvent pas être fusionnés.

Team Foundation Server déverrouille automatiquement un élément lorsque vous archivez des modifications en attente dans l'espace de travail où il est verrouillé. Les verrous sont également libérés si vous utilisez la commande d'annulation pour supprimer des modifications en attente.

Les verrouillages sur les dossiers sont implicitement récursifs. Si vous verrouillez un dossier, vous n'êtes pas tenu de verrouiller les fichiers qu'il contient à moins que vous ne souhaitiez appliquer le verrou d'extraction, plus restrictif, à un fichier situé dans un dossier pourvu d'un verrou d'archivage.

Un seul utilisateur à la fois peut maintenir un verrouillage sur un fichier ou un dossier particulier. Vous pouvez utiliser la commande d'état pour déterminer quels sont les fichiers verrouillés sur le serveur du contrôle de version Team Foundation et par qui ils ont été verrouillés.

Un verrou peut être ajouté directement ou dans le cadre de plusieurs autres opérations, notamment le changement de nom, l'extraction, la suppression, la restauration, la fusion, la création de branches et l'ajout au contrôle de version. Lorsque vous verrouillez un élément dans le cadre d'un ajout au contrôle de version ou d'une création de branche, Team Foundation Server ajoute le verrou sur le chemin d'accès au serveur sur lequel le nouvel élément sera créé. Cela empêche un autre utilisateur d'ajouter ou de créer des branches d'un fichier au même emplacement. Lorsque vous verrouillez un élément à l'aide de la commande Renommer, les anciens et les nouveaux chemins d'accès au serveur sont verrouillés.

Déverrouiller un élément

Vous pouvez déverrouiller un élément explicitement en utilisant la commande de déverrouillage ou implicitement pendant l'archivage. Lorsque vous archivez des modifications en attente sur un élément verrouillé, Team Foundation Server supprime tous les verrous.

Verrouiller des dossiers ou des fichiers

Pour verrouiller un fichier ou un dossier à partir de l'Explorateur de projets ou de l'Explorateur de package

1. Cliquez avec le bouton droit sur le fichier ou dossier que vous souhaitez verrouiller, pointez sur Équipe, puis cliquez sur Verrouiller.

   La boîte de dialogue Verrouiller les fichiers s'affiche.

2. Dans la boîte de dialogue Verrouiller les fichiers, vérifiez que la case à cocher qui correspond au fichier ou dossier que vous souhaitez verrouiller est activée.

3. Exécutez l'une des tâches suivantes :

   • Cliquez sur Archiver - Empêcher les autres utilisateurs d'archiver, mais les autoriser à effectuer des extractions.

   • Cliquez sur Extraire - Empêcher les autres utilisateurs d'extraire et d'archiver.

   Pour plus d'informations sur les types de verrous, consultez Fonctionnement des verrous.

4. Cliquez sur OK pour verrouiller le dossier ou fichier.

Pour verrouiller un fichier ou un dossier à partir de l'Explorateur du contrôle de code source

1. Ouvrez l'Explorateur du contrôle de code source.

   Pour plus d'informations, consultez Ouvrir l'Explorateur du contrôle de code source.

2. Dans l'Explorateur du contrôle de code source, cliquez avec le bouton droit sur le dossier ou fichier auquel vous souhaitez appliquer un verrou, puis cliquez sur Verrouiller.

   La boîte de dialogue Verrouiller les fichiers s'affiche.

3. Dans la boîte de dialogue Verrouiller les fichiers, vérifiez que la case à cocher qui correspond au fichier ou dossier que vous souhaitez verrouiller est activée.

4. Exécutez l'une des tâches suivantes :

   • Cliquez sur Archiver - Empêcher les autres utilisateurs d'archiver, mais les autoriser à effectuer des extractions.

   • Cliquez sur Extraire - Empêcher les autres utilisateurs d'extraire et d'archiver.

   Pour plus d'informations sur les types de verrous, consultez Fonctionnement des verrous.

5. Cliquez sur OK pour verrouiller le dossier ou fichier.

Une modification de verrou est ajoutée à la liste de modifications en attente pour le dossier ou fichier. Si ce dossier ou fichier s'affiche dans l'Explorateur de projets ou l'Explorateur de package, l'icône indique que l'élément est verrouillé.

Pour verrouiller un fichier ou un dossier à partir d'une invite de commandes

1. À l'invite de commandes, indiquez les répertoires du dossier qui contient les fichiers ou dossiers que vous souhaitez verrouiller.

2. Tapez tf lock /lock:LockType ItemSpec, puis appuyez sur Entrée. Remplacez LockType par checkin ou checkout. Remplacez ItemSpec par le fichier ou dossier que vous souhaitez verrouiller.

   Pour obtenir la syntaxe complète de la commande de verrouillage, consultez la rubrique suivante sur le site Web Microsoft : Lock, commande (contrôle de version Team Foundation) (page éventuellement en anglais).

Déverrouiller des dossiers ou des fichiers

Pour déverrouiller un fichier ou un dossier à partir de l'Explorateur de projets ou de l'Explorateur de package

• Cliquez avec le bouton droit sur le fichier ou dossier que vous souhaitez déverrouiller, pointez sur Équipe, puis cliquez sur Déverrouiller.

Pour déverrouiller un fichier ou un dossier à partir de l'Explorateur du contrôle de code source

1. Ouvrez l'Explorateur du contrôle de code source.

   Pour plus d'informations, consultez Ouvrir l'Explorateur du contrôle de code source.

2. Dans l'Explorateur du contrôle de code source, cliquez avec le bouton droit sur le dossier ou fichier que vous souhaitez déverrouiller, puis cliquez sur Déverrouiller.

Une modification de verrou est supprimée de la liste de modifications en attente pour le dossier ou fichier. Si ce dossier ou fichier s'affiche dans l'Explorateur de projets ou l'Explorateur de package, l'icône indique que l'élément est déverrouillé.

Pour déverrouiller un fichier ou un dossier à partir d'une invite de commandes

1. Ouvrez une invite de commandes, puis indiquez les répertoires des fichiers ou dossiers que vous souhaitez déverrouiller.

2. Tapez tf lock /lock:none ItemSpec, puis appuyez sur Entrée. Remplacez ItemSpec par le fichier ou dossier que vous souhaitez déverrouiller.

   Pour obtenir la syntaxe complète de la commande de verrouillage, consultez la rubrique suivante sur le site Web Microsoft : Lock, commande (contrôle de version Team Foundation) (page éventuellement en anglais).

Voir aussi

Autres ressources

Utilisation du contrôle de version (Team Explorer Everywhere)

Utilisation de l'Explorateur du contrôle de code source (Team Explorer Everywhere)

Utilisation d'espaces de travail Team Foundation Server (Team Explorer Everywhere)