Rechercher des modifications de code et d’autres historiques avec CodeLens

Visual Studio CodeLens vous aide à rester concentré sur votre travail pendant que vous découvrez ce qui s’est passé à votre code , tout cela sans quitter l’éditeur de code IDE (Interactive Development Environment). Vous pouvez trouver des références à un élément de code, des modifications apportées à votre code, des bogues liés, des éléments de travail Azure DevOps, des révisions de code et des tests unitaires.

Note

CodeLens est disponible dans l’édition Community de Visual Studio, mais les indicateurs de contrôle de code source ne sont pas disponibles dans cette édition.

CodeLens peut vous montrer où et comment les parties individuelles de votre code sont utilisées dans votre solution :

Affichez les détails des modifications du code de l’utilisateur et utilisez l’option de clic droit Envoyer un e-mail à l’<utilisateur> pour contacter les utilisateurs sans quitter l’éditeur de code :

Pour choisir les indicateurs que vous souhaitez voir ou pour désactiver CodeLens et activer, accédez à Outils>Options>Éditeur de texte>Toutes les langues>CodeLens.

Raccourcis clavier dans Visual Studio 2022

La plupart des opérations décrites dans les sections suivantes sont disponibles à l’aide de raccourcis clavier dans la fenêtre de l’éditeur de code Visual Studio.

Pour utiliser le clavier pour sélectionner des indicateurs, sélectionnez et maintenez la touche Alt pour afficher les touches numériques associées, puis sélectionnez le numéro sur le clavier correspondant à l’indicateur souhaité :

Note

Pour sélectionner l’indicateur révisions, sélectionnez Alt lors de l’utilisation des touches flèche gauche et flèche droite pour parcourir.

Rechercher des références à votre code

Vous trouverez des références en C# ou en Visual Basic code.

1. Dans l’éditeur de code, sélectionnez l’indicateur des références ou utilisez le raccourci clavier Alt+2.

   

   Note

   Si l’indicateur affiche 0 références, cela signifie que vous n’avez aucune référence dans votre code C# ou Visual Basic. Toutefois, il peut y avoir des références dans d’autres éléments de projet tels que .xaml et les fichiers .aspx.

2. Pour afficher le code de référencement, pointez sur la référence dans la liste.

   

3. Pour ouvrir le fichier qui contient la référence, double-cliquez sur la référence.

Créer un mappage de code

Pour afficher les relations entre le code et ses références, vous pouvez créer un mappage de code. Dans la barre d’outils Carte de code, développez le menu déroulant Afficher les éléments connexes, puis sélectionnez Rechercher toutes les références :

Rechercher des modifications dans votre code

Inspectez l’historique de votre code pour savoir ce qui s’est passé à votre code. Vous pouvez également passer en revue les modifications avant qu’elles ne soient fusionnées dans votre code afin de mieux comprendre comment les modifications dans d’autres branches peuvent affecter votre code.

Tu as besoin de:

• Visual Studio Enterprise ou Visual Studio Professional

• Git ou Azure DevOps Server (anciennement Team Foundation Server) ou Team Foundation Version Control (TFVC)

Pour le code C# (.cs) ou Visual Basic (.vb) stocké avec TFVC ou Git, les détails codeLens sont visibles au niveau de la classe et de la méthode (indicateurs de au niveau de l’élément de code) dans le fichier :

Pour les types de fichiers autres que .cs ou .vb, l’indicateur Afficher le codelens au niveau du fichier option vous permet d’afficher les détails de CodeLens pour l’intégralité du fichier. Les indicateurs de au niveau du fichier s’affichent en bas du fichier dans l’éditeur de code :

Indicateurs au niveau de l’élément de code

Les indicateurs au niveau de l’élément de code vous permettent de voir qui a modifié votre code et les modifications qu’ils ont apportées. Les indicateurs de niveau élément de code sont disponibles pour le code C# et Visual Basic.

Vous pouvez également afficher l’historique des modifications lorsque vous utilisez TFVC ou Azure DevOps Services :

La période par défaut est les 12 derniers mois (un an).

Pour afficher un historique détaillé de toutes les modifications, y compris celles datant de plus d'un an, sélectionnez Afficher toutes les modifications de fichier, ce qui ouvre une fenêtre Historique. Dans la fenêtre Historique, vous pouvez afficher tous vos fichiers qui se trouvent dans un référentiel Git, et sélectionner l'indicateur de changements au niveau de l’élément de code pour plus de détails :

Indicateurs au niveau du fichier

Vous pouvez également trouver des modifications pour un fichier entier avec des indicateurs de niveau fichier en bas de la fenêtre dans l’éditeur de code.

Note

Les indicateurs au niveau du fichier ne sont pas disponibles pour les fichiers C# et Visual Basic.

Pour obtenir plus de détails sur une modification, cliquez avec le bouton droit sur l’élément. Selon que vous utilisez TFVC ou Git, vous pouvez comparer les versions du fichier, afficher les détails et suivre l’ensemble de modifications, obtenir la version sélectionnée du fichier et envoyer un e-mail à l’auteur de cette modification. Certains détails s’affichent dans Team Explorer lorsqu’ils sont activés ; sinon, les détails s’affichent dans le volet Modifications Git. Vous pouvez également voir les détails de la barre de défilement horizontale en bas de l’éditeur de code.

Les indicateurs indiquent qui a modifié votre code au fil du temps, ce qui peut vous aider à trouver des modèles dans les modifications de votre équipe et à évaluer leur impact :

À compter de Visual Studio 2022 version 17.12 Preview 2, vous pouvez afficher ou masquer des indicateurs au niveau du fichier dans la barre de défilement horizontale de l’éditeur de code avec l’option Tools > Options > Éditeur de texte > Indicateur Avancé>Afficher l’indicateur CodeLens au niveau du fichier option. Cette option met à jour la visibilité des types de fichiers qui implémentent le contrôle CodeLens au niveau du fichier dans la barre de défilement de l’éditeur inférieur, telle que XAML, HTML et CSS. L’option n’affecte pas les fichiers qui contiennent codeLens inline (C# et VB).

Rechercher les modifications dans votre branche actuelle

Votre équipe peut avoir plusieurs branches, telles qu’une branche principale et une branche de développement enfant, pour réduire le risque de rupture du code stable.

Vous pouvez découvrir combien de contributeurs ont modifié votre code et combien de changements ont été effectués dans la branche principale en sélectionnant le raccourci clavier Alt+0

Rechercher quand votre code a été branché

Pour savoir quand votre code a été branché, accédez à votre code dans la branche enfant. Ensuite, sélectionnez l'indicateur modifications (ou sélectionnez Alt+0) :

Rechercher les modifications entrantes à partir d’autres branches

Vous pouvez afficher les modifications entrantes et vous n’avez pas besoin de quitter votre branche actuelle pour passer en revue une modification.

Rechercher quand les modifications ont été fusionnées

Vous pouvez voir quand les modifications ont été fusionnées. Vous pouvez donc déterminer quelles modifications sont incluses dans votre branche.

Comparer une modification entrante avec votre version locale

Pour comparer une modification entrante à votre version locale, double-cliquez sur l’ensemble de modifications ou sélectionnez Maj + F10.

Icônes de branche

L’icône de la branche colonne indique comment la branche est liée à la branche dans laquelle vous travaillez.

Icône	Le changement provient de
	La branche actuelle
	Branche parente
	Une branche enfant
	Une branche homologue
	Une branche plus éloignée qu’un parent, un enfant ou un homologue
	Fusion de la branche parente vers une branche enfant
	Fusion d’une branche enfant vers la branche parente
	Fusion à partir d’une branche non liée (fusion sans base)

Éléments de travail liés

Recherchez les éléments de travail liés en sélectionnant l’indicateur des éléments de travail ou en utilisant le raccourci clavier Alt+8.

Révisions de code liées

Recherchez des révisions du code liées en sélectionnant l’indicateur Révisions. Pour utiliser le clavier, maintenez la touche Alt enfoncée, puis sélectionnez flèche gauche ou flèche droite pour parcourir les options d’indicateur.

Bogues liés

Recherchez les bogues liés en sélectionnant l’indicateur de bogues ou utilisez le raccourci clavier Alt + 7.

Contactez le propriétaire d’un élément

Recherchez l’auteur d’un élément en sélectionnant l’indicateur auteurs ou utilisez le raccourci clavier Alt + 5.

Vous pouvez également ouvrir le menu contextuel d’un élément pour afficher les options de contact. (Si Teams est installé, vous disposez d’autres options de communication disponibles.)

Tests unitaires associés

Vous pouvez découvrir des tests unitaires qui existent pour votre code C# ou Visual Basic sans ouvrir Explorateur de tests.

1. Accédez à du code d'application avec le code de test unitaire associé.

2. Si nécessaire, générez votre application pour charger les indicateurs de test CodeLens.

3. Passez en revue les tests du code à l’aide du raccourci clavier Alt + 3.

4. Si vous voyez l'icône Avertissement, les tests n'ont pas encore été exécutés, alors exécutez-les.

5. Pour passer en revue la définition d’un test, double-cliquez sur l’élément de test dans la fenêtre d’indicateur CodeLens et ouvrez le fichier de code dans l’éditeur.

6. Pour passer en revue les résultats du test, choisissez l’état du test Échec ou indicateur de passé ( ou ) ou utilisez le raccourci clavier Alt+1.

7. Pour voir combien de contributeurs ont changé ce test, qui a modifié ce test ou combien de modifications ont été apportées à ce test, trouver l’historique de votre code et les éléments liés.

Questions et réponses

Q : Comment désactiver ou activer CodeLens ou choisir les indicateurs à afficher ?

R : Vous pouvez désactiver ou activer les indicateurs, à l’exception de l’indicateur de référence. Accédez à Outils>Options>Éditeur de texte>Toutes les langues>CodeLens.

Lorsque les indicateurs sont activés, vous pouvez également ouvrir les options CodeLens à partir des indicateurs. Vous pouvez également activer et désactiver les indicateurs au niveau du fichier CodeLens à l’aide des icônes de chevron en bas de la fenêtre de l’éditeur.

Q : Où est CodeLens ?

A : CodeLens apparaît dans le code C# et Visual Basic au niveau de la méthode, de la classe, de l’indexeur et de la propriété. CodeLens apparaît au niveau du fichier pour tous les autres types de fichiers.

• Vérifiez que CodeLens est activé. Accédez à Outils>Options>Éditeur de texte>Toutes les langues>CodeLens.

• Les indicateurs liés à Azure DevOps s’affichent uniquement lorsque les éléments de travail sont liés au code et lorsque vous disposez des autorisations nécessaires pour ouvrir des éléments de travail liés. Vérifiez que vous disposez des autorisations de membre de l’équipe.

• Les indicateurs de test unitaire n’apparaissent pas lorsque le code de l’application n’a pas de tests unitaires. Les indicateurs d’état de test apparaissent automatiquement dans les projets de test. Si vous savez que le code de votre application comporte des tests unitaires, mais que les indicateurs de test n’apparaissent pas, essayez de générer la solution (Ctrl + Maj + B).

Conseil

CodeLens est disponible dans Visual Studio Community Edition. Toutefois, les indicateurs de contrôle de code source ne sont pas disponibles dans cette édition.

Q : Pourquoi est-ce que je ne vois pas les détails d'élément de travail pour une validation ?

R : Ce scénario peut se produire, car CodeLens ne trouve pas les éléments de travail dans Azure Boards. Vérifiez que vous êtes connecté au projet qui a ces éléments de travail et que vous disposez des autorisations nécessaires pour afficher ces éléments de travail. Les détails de l’élément de travail peuvent également ne pas s’afficher si la description de la validation contient des informations incorrectes sur les ID d’élément de travail dans Azure Boards.

Q : Comment modifier la police et la couleur de CodeLens ?

R : Accédez à Outils>Options>Environnement>Polices et couleurs.

Pour utiliser le clavier :

1. Sélectionnez alt + T + O pour ouvrir la boîte de dialogue options .

2. Sélectionnez la Flèche du haut ou la Flèche du bas pour accéder au nœud Environnement, puis sélectionnez la Flèche gauche pour développer le nœud.

3. Sélectionnez la Flèche du bas pour accéder à Polices et couleurs.

4. Sélectionnez Onglet pour accéder à la liste Afficher les paramètres pour, puis sélectionnez la Flèche du bas pour sélectionner CodeLens.

Q : Puis-je déplacer l’affichage de CodeLens ?

A : Oui, choisissez l’icône Dock pour ancrer CodeLens en tant que fenêtre.

Q : Comment actualiser les indicateurs ?

R : Le processus d’actualisation est différent en fonction de l’indicateur :

• Références : cet indicateur se met automatiquement à jour quand le code change. Si l’indicateur Références est ancré en tant que fenêtre individuelle, actualisez-le en sélectionnant Actualiser.

• Équipe : actualisez ces indicateurs en sélectionnant Actualiser les indicateurs d’équipe CodeLens dans le menu contextuel.

• Test: Rechercher des tests unitaires pour votre code pour actualiser l’indicateur Test.

Q : Qu’est-ce que « Version locale » ?

R : la flèche Version locale pointe vers l’ensemble de modifications le plus récent dans votre version locale d’un fichier. Lorsque le serveur a des ensembles de modifications plus récents, ils apparaissent avant ou après la flèche version locale, selon l’ordre utilisé pour trier les ensembles de modifications.

Q : Mes indicateurs de test CodeLens n’apparaissent plus dans mon fichier lorsque j’ouvre ma solution pour la première fois. Comment puis-je les charger ?

R : regénérez votre projet afin de charger les indicateurs de test CodeLens dans votre fichier. Pour améliorer les performances, Visual Studio n’extrait plus les informations sources pour les indicateurs de test lorsque les fichiers de code sont chargés. Les indicateurs de test sont chargés après une build ou lorsque vous accédez à un test en double-cliquant dessus dans Explorateur de tests.

Contenu connexe

• À propos du contrôle de version Git dans Visual Studio
• Fonctionnalités de l'éditeur de code