Examiner du code avec l'affichage de titres CodeLens dans Visual Studio

Restez concentré sur votre travail pendant que vous cherchez ce qui est arrivé à votre code, sans quitter l'éditeur (nécessite Visual Studio Ultimate).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.

CodeLens indicators in the code editor

Contactez votre équipe à propos de ces changements sans quitter l'éditeur :

CodeLens - Contact your team

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

Rechercher des références à votre code

Vous aurez besoin de :

  • Visual Studio Ultimate

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

  • La plus récente mise à jour de Visual Studio 2013 afin de pouvoir travailler avec les solutions qui partagent le code entre plusieurs applications

  1. Choisissez l'indicateur de références (Alt + 2) :

    CodeLens - Choose references indicator

    Quand 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.

  2. Pour afficher le code de référencement, déplacez votre souris sur la référence ou double-cliquez dessus :

    CodeLens - Peek reference

  3. Pour visualiser les relations entre ce code et ses références, créez une carte de code.

    CodeLens - References on code map

Rechercher l'historique de votre code et les éléments liés

Examinez l'historique de votre code pour savoir ce qui lui est arrivé.Sinon, examinez les changements avant qu'ils ne soient fusionnés dans votre code. Ainsi, vous pourrez mieux comprendre la façon dont les modifications des autres branches peuvent affecter votre code.

Vous aurez besoin de :

  • Visual Studio Ultimate

  • Team Foundation Server (même version) ou Visual Studio Online

  • Code Visual C# .NET ou Visual Basic .NET qui est vérifié dans Visual Studio Online ou Team Foundation Server à l'aide du vérification contrôle de version Team Foundation ou deGit.Si votre référentiel Git est hébergé dans TfGit, vous pouvez également trouver des liens vers des éléments de travail TFS.

  • La plus récente mise à jour de Visual Studio 2013 afin de pouvoir trouver aussi les modifications dans d'autres branches et de pouvoir travailler avec les solutions qui partagent le code entre plusieurs applications

  • Lync 2013, Lync Basic 2013 ou Lync 2010 pour contacter votre équipe à partir de l'éditeur

Rechercher des modifications dans votre code

Déterminer qui qui a modifié votre code (Alt+4) dans le contrôle de version Team Foundation (TFVC) :

Get change history for your code in TFVC

Ou dans Git où vous pouvez également visualiser la date des dernières modifications apportées.

Get change history for your code in Git

Pour obtenir plus d'informations sur une modification, cliquez avec le bouton droit sur cet élément, puis cliquez sur Afficher les détails.Ces informations s'affichent dans Team Explorer.

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: Find when your code was branched

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

CodeLens: Find how many changes in your branch

Ou découvrez combien de personnes ont modifié votre code (Alt+4) :

CodeLens: Find how many people changed your code

Si un signe plus (+) et un autre nombre apparaissent à côté de l'indicateur de modifications ou d'auteurs, cela signifie que votre code a des modifications plus récentes dans votre branche actuelle de TFS.

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 + 5) :

CodeLens: Find when your code was branched

Rechercher les modifications entrantes d'autres branches

CodeLens: Find code changes in other branches

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

CodeLens: Change checked into another branch

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

CodeLens: See incoming change from another branch

Savoir quand des modifications ont été fusionnées

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

CodeLens - Merged changes between branches

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

CodeLens - Merged chagnes between branches

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

CodeLens: Compare incoming change with local

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

Que signifient les icônes ?

Icône

D'où provient la modification ?

CodeLens: Change from current branch icon

La branche actuelle

CodeLens - Change from parent branch icon

La branche parente

CodeLens - Change from child branch icon

Un branche enfant

CodeLens - Change from peer branch icon

Une branche homologue

CodeLens - Change from branch further away icon

Une branche plus éloignée qu'un parent, enfant ou homologue

CodeLens: Merge from parent icon

Une fusion de la branche parente à une branche enfant

CodeLens: Merge from child branch icon

Une fusion d'une branche enfant à la branche parente

CodeLens: Merge from unrelated branch icon

Une fusion d'une branche sans relation (fusion sans base)

Rechercher des éléments de travail liés (Alt+7)

CodeLens - Find work items for specific code

Rechercher des révisions de code liées (Alt+8)

CodeLens - View code review requests

Rechercher des bogues liés (Alt+9)

CodeLens - Find bugs linked to changesets

Contacter le propriétaire d'un élément (Maj + F10)

CodeLens - Contact your team

Rechercher des tests unitaires pour votre code

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 Ultimate

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

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

  • La plus récente mise à jour de Visual Studio 2013 afin de pouvoir trouver les modifications dans d'autres branches et de pouvoir travailler avec les solutions qui partagent le code entre plusieurs applications

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

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

    CodeLens - Choose test status in code editor

  3. Si une icône d'avertissement s'affiche CodeLens - Unit tests not yet run warning, exécutez les tests.

    CodeLens - View unit tests not run yet

  4. Pour examiner la définition d'un test, double-cliquez sur le test.

    CodeLens - Choose a unit test

    CodeLens - Go to unit test definition

  5. Vérifiez les résultats du test.Choisissez l'indicateur d'état de test (CodeLens - Unit test failed icon ou CodeLens - Unit test passed icon), ou appuyez sur Alt+1.

    CodeLens - See unit test result

  6. Pour connaître le nombre de personnes qui ont modifié ce test, savoir qui l'a modifié ou connaître le nombre de modifications apportées au test, recherchez l'historique du code.

Q et R

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 - Turn indicators off or on

Q : où est CodeLens ?

R : CodeLens apparaît uniquement 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é.

  • 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 ?

R : ils ne s'affichent pas si vous n'êtes pas connecté à Lync, si vous ne l'avez pas installé, ou si la configuration Lync n'est pas prise en charge.Toutefois, vous pouvez toujours envoyer du courrier :

CodeLens - Contact changeset owner by mail

CodeLens - Contact changeset owner by mail

CodeLens - Send mail about a changeset

Quelles sont les configurations de Lync prises en charge ?

  • Lync 2013 (32 bits ou 64 bits), seul ou avec Office 2013

  • Lync Basic 2013 seul (32 bits ou 64 bits, mais pas avec Windows 8.1)

  • Lync 2010 seul (32 bits ou 64 bits)

CodeLens ne prend pas en charge le fait d'avoir différentes versions de Lync installées.Il se peut que Lync ne soit pas localisé 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 - Change font and color settings

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 : Quelle est la différence entre l'indicateur d'auteurs et l'indicateur de modifications ?

R : L'indicateur d'auteurs indique le nombre de personnes ayant modifié ce code.L'indicateur de modifications indique le nombre de modifications qui ont été apportées à ce code.Les deux indicateurs affichent les mêmes informations sur les modifications.

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 - Dock as window

  • Équipe : actualisez manuellement ces indicateurs ici :

    CodeLens - Refresh indicators

  • Test : exécutez tous les tests ou des tests spécifiques pour actualiser cet indicateur.

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

R : oui, choisissez CodeLens - Dock as a window pour ancrer CodeLens en tant que fenêtre.

CodeLens - Dock as window

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.