Rechercher les modifications de code et d'autres historiques avec CodeLens

 

Date de publication : août 2016

Pour obtenir la dernière documentation sur Visual Studio 2017 RC, consultez Documentation Visual Studio 2017 RC.

Restez concentré sur votre travail pendant que vous cherchez ce qui est arrivé à votre code, sans quitter l'éditeur. Trouvez les références et les changements relatifs à votre code, les bogues liés, les éléments de travail, les révisions du code et les tests unitaires.

System_CAPS_ICON_note.jpg Remarque

CodeLens est disponible uniquement dans les éditions Visual Studio Enterprise et Visual Studio Professional. Il n'est pas disponible dans l'édition Visual Studio Community.

Recherchez où et comment les différentes parties de votre code sont utilisées dans votre solution :

Indicateurs CodeLens dans l'éditeur de code

Contactez votre équipe à propos de ces modifications dans votre code, sans quitter l'éditeur :

CodeLens - Contacter votre équipe

Pour choisir les indicateurs à visualiser ou pour activer ou désactiver CodeLens, accédez à Outils, Options, Éditeur de texte, Tous les langages, CodeLens.

Vous aurez besoin de :

  • Visual Studio Enterprise ou Visual Studio Professional

  • Code Visual C# .NET ou Visual Basic .NET

Choisissez l'indicateur de références (Alt+2). Si vous avez 0 référence, cela signifie que vous n'avez aucune référence de code Visual C# ou Visual Basic. Ceci n'inclut pas les références d'autres éléments, comme les fichiers XAML et ASPX.

CodeLens - Choisir l'indicateur des références

Pour afficher le code de référencement, placez la souris sur la référence.

CodeLens - Lire la référence

Pour ouvrir le fichier contenant la référence, double-cliquez sur cette dernière.

Pour afficher les relations entre ce code et ses références, créez une carte du code et choisissez Afficher toutes les références dans le menu contextuel de la carte du code.

CodeLens - Références sur le code de mappage

Examinez l'historique de votre code pour savoir ce qui lui est arrivé. Vous pouvez également examiner les modifications avant qu'elles soient fusionnées dans votre code. Cela vous permet de mieux comprendre la façon dont les modifications des autres branches peuvent affecter votre code.

Vous aurez besoin de :

Pour le code Visual C# .NET ou Visual Basic .NET stocké avec la gestion de version Team Foundation (TFVC) ou Git, vous obtenez les détails CodeLens au niveau des classes et des méthodes (indicateurs de niveau élément de code). Si votre dépôt Git est hébergé dans TfGit, vous obtenez également des liens vers les éléments de travail TFS.

Indicateurs de code de niveau élément

Pour tous les autres types de fichiers que vous pouvez ouvrir dans l'éditeur Visual Studio, vous obtenez les détails CodeLens pour l'intégralité du fichier dans un endroit unique au bas de la fenêtre (indicateurs de niveau fichier).

Indicateurs CodeLens de niveau fichier

Pour utiliser le clavier afin de sélectionner des indicateurs, maintenez enfoncée la touche Alt pour afficher les touches numériques associées.

Appuyer sur ALT pour afficher les numéros d'accès clavier

Rechercher des modifications dans votre code

Recherchez qui a modifié votre code C# ou Visual Basic, ainsi que les modifications apportées, dans les indicateurs de niveau d'élément de code C’est ce que vous voyez quand vous utilisez la gestion de version Team Foundation (TFVC) dans Team Foundation Server ou Visual Studio Team Services.

CodeLens : obtenir l'historique des modifications de votre code dans TFVC

La période prise en charge par défaut s'étend sur les 12 derniers mois. Si votre code est stocké dans Team Foundation Server, vous pouvez modifier cette période en exécutant la commande TFSConfig avec la commande CodeIndex et l'indicateur /indexHistoryPeriod.

Pour afficher un historique détaillé de toutes les modifications, y compris celles de plus d'un an, choisissez Afficher toutes les modifications de fichier.

Afficher toutes les modifications de code

La fenêtre Historique s'ouvre alors pour les ensembles de modifications.

Fenêtre d'historique de toutes les modifications de code

Quand vos fichiers sont dans un dépôt Git et que vous choisissez l'indicateur de modifications de niveau d'élément de code, voici ce que vous voyez.

CodeLens : obtenir l'historique des modifications de votre code dans Git

Recherchez les modifications pour un fichier entier (à l'exception des fichiers C# et Visual Basic) dans les indicateurs de niveau fichier au bas de la fenêtre.

CodeLens : obtenir des détails sur le fichier de code

Pour obtenir plus d'informations sur une modification, cliquez avec le bouton droit sur cet élément. Selon que vous utilisez TFVC ou Git, vous obtenez une série d'options permettant de comparer les versions du fichier, d'afficher les détails et d'effectuer le suivi de l'ensemble de modifications, d'obtenir la version sélectionnée du fichier et d'envoyer un courrier électronique à l'auteur de cette modification. Certaines de ces informations apparaissent dans Team Explorer.

Vous pouvez également voir qui a modifié votre code au fil du temps. Cette fonctionnalité vous permet de découvrir des modèles dans les modifications effectuées par votre équipe, et d’en évaluer l’impact.

CodeLens : voir l'historique des modifications du code sous forme de graphique

Rechercher des modifications dans votre branche actuelle

Supposez que votre équipe a plusieurs branches (une branche principale et un développement enfant) pour réduire le risque de rupture du code stable :

CodeLens : Trouver quand une branche a été créée dans votre code

Découvrez combien de personnes ont modifié votre code et combien de modifications ont été apportées (Alt + 6) dans votre branche principale :

CodeLens : rechercher le nombre de modifications dans votre branche

Savoir quand une branche a été créée dans votre code

Accédez à votre code dans la branche enfant, par exemple la branche Dev. Choisissez l'indicateur de modifications (Alt + 6) :

CodeLens : savoir quand une branche a été créée dans votre code

Rechercher les modifications entrantes d'autres branches

CodeLens : trouver les modifications de code dans d'autres branches

…comme cette résolution de bogue dans la branche Dev :

CodeLens : modification archivée dans une autre branche

Vous pouvez examiner cette modification sans quitter votre branche actuelle (Main) :

CodeLens : voir les modifications entrantes d’une autre branche

Savoir quand des modifications ont été fusionnées

Vous pouvez ainsi identifier les modifications qui sont incluses dans votre branche :

CodeLens - Modifications fusionnées entre les branches

Par exemple, votre code dans la branche Main contient maintenant la résolution de bogue de la branche Dev :

CodeLens - Modifications fusionnées entre les branches

Comparer une modification entrante à votre version locale (Maj + F10)

CodeLens : Comparer la modification entrante et la modification locale

Vous pouvez également double-cliquer sur l'ensemble de modifications.

Que signifient les icônes ?

IcôneD'où provient la modification ?
CodeLens - icône Changer à partir de la branche actuelleLa branche actuelle
CodeLens - icône Changer à partir de la branche parentLa branche parente
CodeLens : icône Changer à partir de la branche enfantUn branche enfant
CodeLens - icône Changer à partir d'une branche homologueUne branche homologue
CodeLens - icône Changer à partir d'une branche plus éloignéeUne branche plus éloignée qu'un parent, enfant ou homologue
CodeLens : icône Fusionner à partir du parentUne fusion de la branche parente à une branche enfant
CodeLens - icône Fusionner à partir de la branche enfantUne fusion d'une branche enfant à la branche parente
CodeLens - icône Fusionner à partir d'une branche sans relationUne fusion d'une branche sans relation (fusion sans base)

Rechercher des éléments de travail liés

CodeLens - Rechercher des éléments de travail pour un code spécifique

Rechercher des révisions de code liées

CodeLens - Afficher les demandes de révision du code

Rechercher des bogues liés

CodeLens - Rechercher les bogues liés aux ensembles de modifications

Contacter le propriétaire d'un élément

Contacter le propriétaire d'un élément

Ouvrez le menu contextuel d'un élément pour afficher les options de contact. Si vous avez installé Lync ou Skype Entreprise, les options suivantes apparaissent :

Options de contact d'un élément

Découvrez en plus sur les tests unitaires qui existent pour votre code sans ouvrir l'Explorateur de tests. Vous aurez besoin de :

  • Visual Studio Enterprise ou Visual Studio Professional

  • Code Visual C# .NET ou Visual Basic .NET

  • Un projet de test unitaire qui comporte des tests unitaires pour votre code d'application

  1. Accédez au code d'application qui contient des tests unitaires.

  2. Passez en revue les tests pour ce code (Alt+3).

    CodeLens - Choisir l’indicateur d’état de test dans l’éditeur de code

  3. Si une icône d'avertissement s'affiche CodeLens - Avertissement sur les tests unitaires non encore exécutés, exécutez les tests.

    CodeLens - Afficher les tests unitaires non encore exécutés

  4. 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 pour ouvrir le fichier de code dans l'éditeur.

    CodeLens - Accéder à la définition des tests unitaires

  5. Vérifiez les résultats du test. Choisissez l'indicateur d'état de test (CodeLens - Icône d'échec du test unitaire ou CodeLens - Icône de réussite du test unitaire), ou appuyez sur Alt+1.

    CodeLens - Voir le résultat des tests unitaires

  6. Pour connaître le nombre de personnes qui ont modifié ce test, savoir qui a modifié ce test ou connaître le nombre de modifications ayant affecté ce test, Rechercher l'historique de votre code et les éléments liés.

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

R : Vous pouvez activer ou désactiver les indicateurs, à l'exception de l'indicateur des références. Accédez à Outils, Options, Éditeur de texte, Tous les langages, CodeLens.

Lorsque les indicateurs sont activés, vous pouvez aussi ouvrir les options CodeLens à partir des indicateurs.

CodeLens - Activer ou désactiver les indicateurs

Activez et désactivez les indicateurs de niveau fichier CodeLens à l'aide des icônes en forme de chevron situées en bas de la fenêtre de l'éditeur.

Activer et désactiver les indicateurs au niveau des fichiers

Q : Où est CodeLens ?

R : CodeLens apparaît dans le code Visual C# .NET et Visual Basic .NET, 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.

  • Assurez-vous que CodeLens est activé. Accédez à Outils, Options, Éditeur de texte, Tous les langages, CodeLens.

  • Si votre code est stocké dans TFS, assurez-vous que l'indexation de code est activée en utilisant la commande CodeIndex avec la commande TFS Config.

  • Les indicateurs liés au TFS s'affichent uniquement si des éléments de travail sont liés au code et lorsque vous êtes autorisé à ouvrir les éléments de travail liés.Confirmez que vous disposez des autorisations de membre de l'équipe.

  • Les indicateurs de test unitaire ne s'affichent pas quand le code de l'application ne contient pas de tests unitaires. Les indicateurs d'état de test s'affichent automatiquement dans les projets de test. Si vous savez que le code de votre application contient des tests unitaires, mais que les indicateurs de test ne s'affichent pas, essayez de générer la solution (Ctrl+Maj+B).

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

R : cela peut se produire si CodeLens ne trouve pas les éléments de travail dans TFS. Vérifiez que vous êtes connecté au projet d'équipe contenant ces éléments de travail et que vous disposez des autorisations nécessaires pour visualiser ces éléments de travail. Cela peut également se produire si la description de validation comporte des informations incorrectes sur les ID d'élément de travail dans TFS.

Q : Pourquoi est-ce que je ne vois pas les indicateurs Lync ou Skype ?

R : Ils ne s'affichent pas si vous n'êtes pas connecté à Lync ni à Skype for Business, si vous ne disposez d'aucun de ces logiciels ou si vous ne possédez pas une configuration prise en charge. Toutefois, vous pouvez toujours envoyer du courrier :

CodeLens - Contacter le propriétaire de l'ensemble de modifications par courrier électronique

Quelles sont les configurations de Lync et Skype prises en charge ?

  • Skype for Business (32 bits ou 64 bits)

  • Lync 2010 ou version ultérieure individuelle (32 bits ou 64 bits), mais pas Lync Basic 2013 avec Windows 8.1

CodeLens ne prend pas en charge l'installation de différentes versions de Lync ou de Skype. Elles peuvent ne pas être localisées pour toutes les versions localisées de Visual Studio.

Q : comment changer la police et la couleur de CodeLens ?

R : Ouvrez Outils, Options, Environnement, Polices et couleurs.

CodeLens - Modifier les paramètres de police et de couleurs

Pour utiliser le clavier :

  1. Appuyez sur Alt+T+O pour ouvrir la boîte de dialogue Options.

  2. Appuyez sur Flèche haut ou Flèche bas pour atteindre le nœud Environnement, puis appuyez sur Flèche gauche pour développer le nœud.

  3. Appuyez sur Flèche bas pour accéder à Polices et couleurs.

  4. Appuyez sur Tabulation pour accéder à la liste Afficher les paramètres de, puis appuyez sur Flèche bas pour sélectionner CodeLens.

Q : Puis-je déplacer l'affichage tête haute CodeLens ?

R : oui, choisissez CodeLens - Ancrer en tant que fenêtre pour ancrer CodeLens en tant que fenêtre.

Ancrer la fenêtre d'indicateur CodeLens

Fenêtre ancrée des références CodeLens

Q : Comment actualiser les indicateurs ?

R : cela dépend de l'indicateur :

  • Références : cet indicateur se met automatiquement à jour quand le code change. Si cet indicateur est ancré dans une fenêtre distincte, actualisez-le manuellement ici :

    CodeLens - Ancrer en tant que fenêtre

  • Équipe : actualisez manuellement ces indicateurs ici :

    CodeLens - Actualiser les indicateurs

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

Q : Que signifie « Version locale » ?

R : La flèche Version locale pointe vers l'ensemble de modifications le plus récent dans votre version locale de ce fichier. Lorsque le serveur possède des ensembles de modifications plus récents, ils apparaissent au-dessus ou en-dessous de la flèche Version locale, selon l'ordre utilisé pour trier les ensembles de modifications.

Q : puis-je gérer la façon dont CodeLens traite le code pour afficher l'historique et les éléments liés ?

R : oui, si votre code est dans TFS, utilisez la commande CodeIndex avec la commande TFS Config.

Afficher: