Comment : rechercher du code à l'aide du navigateur de l'architecture

Dans Visual Studio Ultimate, vous pouvez sélectionner les sections verticales ou « fractions » de code que vous souhaitez visualiser à l'aide du navigateur de l'architecture. Vous pouvez explorer le code source dans une solution Visual Studio ou dans du code compilé. Vous pouvez utiliser le navigateur de l'architecture pour parcourir d'autres domaines en installant des fournisseurs supplémentaires. Une fois le code que vous souhaitez visualiser localisé, vous pouvez générer des graphiques pour explorer les relations présentes dans ce code. Pour plus d'informations, consultez Comment : générer des graphiques de dépendance pour le code .NET.

Notes

Dans Visual Studio 2010 Ultimate, le navigateur de l'architecture prend uniquement en charge Visual C# .NET et Visual Basic .NET.  Pour explorer du code C ou C++, téléchargez et installez Visualization and Modeling Feature Pack. Les types suivants du navigateur de l'architecture s'appliquent uniquement au code C et C++ : Unions, Typedefs et Members. Ils n'afficheront pas de résultats si vous les sélectionnez. Pour plus d'informations, consultez Pack de fonctionnalités de visualisation et de modélisation Microsoft Visual Studio 2010.

Dans cette rubrique

• À propos du navigateur de l'architecture

• Rechercher du code source dans une solution Visual Studio

• Rechercher du code compilé dans des fichiers exécutables ou d'assemblys managés

• Affiner les résultats de votre navigation

• Actualiser les résultats de votre navigation

Vous pouvez enregistrer votre session de navigation sous forme de requête (fichier .dgql) de manière à pouvoir la réutiliser par la suite :

• Enregistrer votre session de navigation sous forme de requête

• Rechercher des requêtes enregistrées

À propos du navigateur de l'architecture

Pour ouvrir le navigateur de l'architecture

• Dans le menu Architecture, pointez sur Fenêtres, puis cliquez sur Navigateur de l'architecture.

  Pour redimensionner le navigateur de l'architecture, faites glisser la partie supérieure de la fenêtre jusqu'à la hauteur voulue. Pour déplacer le navigateurde l'architecture, faites glisser sa barre de titre, ou son onglet, vers l'emplacement de votre choix.

  Notes

  Si des fenêtres apparaissent au-dessus du navigateur de l'architecture, telles que la fenêtre Liste d'erreurs ou Sortie, déplacez-les afin qu'elles ne vous empêchent pas de redimensionner ce dernier.

Navigateur de l'architecture : domaines, vues, nœuds, types de nœuds et types de liens

Le navigateur de l'architecture représente les structures sous forme de nœuds et les relations sous forme de liens. Lors de la navigation, il affiche les nœuds dans des colonnes consécutives. La première colonne présente les domaines et vues que vous pouvez consulter. Lorsque vous sélectionnez un domaine et une vue, le navigateur de l'architecture affiche les nœuds disponibles dans cette vue.

Lorsque vous sélectionnez des nœuds dans une colonne, la colonne suivante du navigateur de l'architecture vous montre les nœuds qui sont logiquement liés à votre sélection. Par exemple, si vous sélectionnez des espaces de noms, des types s'affichent dans la colonne suivante. Si vous sélectionnez des types, des membres s'affichent dans la colonne suivante. La colonne d'action réduite qui apparaît sur le côté droit d'une colonne de nœud identifie les relations ou types par défaut des nœuds contenus dans la colonne suivante. Vous pouvez filtrer les résultats de la colonne suivante en développant la colonne d'action et en sélectionnant des types spécifiques de nœuds ou de liens.

Notes

La colonne d'action apparaît en surbrillance lorsque vous placez le pointeur dessus.

Rechercher du code source dans une solution Visual Studio

Pour utiliser les requêtes prédéfinies fournies avec cette version, consultez Rechercher des requêtes enregistrées. Sinon, vous pouvez utiliser la fonction Affichage de solutions ou Affichage de classes dans le navigateur de l'architecture pour parcourir le code source vers le bas jusqu'au niveau des arborescences d'expressions :

• Affichage de classes représente une vue logique d'une solution Visual Studio. Par exemple, vous pouvez naviguer par espace de noms, classes, membres, etc.

  

  Affichage de classes dans le navigateur de l'architecture

• Affichage de solutions représente une vue physique d'une solution Visual Studio. Par exemple, vous pouvez naviguer par projet, fichiers projet, etc.

  

  Affichage de solutions dans le navigateur de l'architecture Rechercher des requêtes enregistrées

Pour rechercher du code dans votre solution

1. Dans la première colonne du Navigateur de l'architecture, sous Visual Studio < nom de la solution >, cliquez sur Affichage de classes ou Affichage de solutions.

   Une colonne de nœud apparaît à droite de la première colonne. Cette colonne affiche tous les nœuds qui sont disponibles dans la vue sélectionnée. Par exemple, si vous avez sélectionné Affichage de classes, tous les espaces de noms qui existent logiquement dans votre solution s'affichent.

2. Dans la colonne de nœud, sélectionnez un ou plusieurs nœuds pour afficher la colonne suivante contenant les nœuds connexes. Pour sélectionner tous les nœuds dans la colonne actuelle, appuyez sur CTRL+A.

3. Répétez l'étape 2 jusqu'à ce que vous trouviez les nœuds souhaités.

   Notes

   Pour recommencer votre requête en effaçant le contenu des colonnes, sous la barre de titre du Navigateur de l'architecture, cliquez sur Effacer les colonnes.

Rechercher du code compilé dans des fichiers exécutables ou d'assemblys managés

Utilisez Sélectionner les fichiers dans le navigateur de l'architecture pour parcourir les assemblys managés vers le bas jusqu'au niveau des appels de méthode à méthode.

Pour rechercher du code compilé

1. Dans le menu Architecture, pointez sur Fenêtres, puis cliquez sur Navigateur de l'architecture.

2. Dans la première colonne, sous Système de fichiers, cliquez sur Sélectionner les fichiers.

3. Dans la boîte de dialogue Ouvrir, recherchez les fichiers exécutables (.exe) ou d'assembly (.dll) managés, sélectionnez-les, puis cliquez sur Ouvrir.

   Une colonne de nœud apparaît, affichant les fichiers sélectionnés.

4. Dans la colonne de nœud, sélectionnez un ou plusieurs fichiers.

   Une autre colonne de nœud apparaît, affichant tous les nœuds des fichiers sélectionnés.

5. Sélectionnez un ou plusieurs nœuds pour afficher la colonne suivante contenant les nœuds connexes. Pour sélectionner tous les nœuds dans la colonne actuelle, appuyez sur CTRL+A.

6. Répétez l'étape 4 jusqu'à ce que vous trouviez les nœuds souhaités.

Affiner les résultats de votre navigation

Vous pouvez affiner les résultats de votre session de navigation de différentes façons :

• Filtrage des nœuds dans la colonne actuelle par nom.

• Filtrage des nœuds dans la colonne actuelle par propriété ou type de nœud.

• Filtrage des nœuds dans la colonne suivante par type de nœud.

• Filtrage des nœuds dans la colonne suivante par type de lien.

• Regroupement des nœuds par conteneur ou valeur de propriété

Filtrer par nom les nœuds de la colonne actuelle

Filtrage de la colonne actuelle par nom

Pour filtrer les nœuds dans la colonne actuelle par nom

1. Dans le Navigateur de l'architecture, en haut de la colonne de nœud, cliquez sur la zone ombrée pour afficher la zone de filtre.

2. Tapez le nom, puis appuyez sur ENTRÉE.

   La colonne actuelle affiche uniquement les nœuds correspondants. Un filigrane indiquant que la colonne est filtrée s'affiche dans l'angle inférieur droit de la colonne.

Filtrer par type de nœud ou propriété les nœuds de la colonne actuelle

Filtrage de la colonne actuelle par type ou propriété

Pour filtrer les nœuds dans la colonne actuelle par type ou propriété

1. Dans le Navigateur de l'architecture, en haut de la colonne de nœud, cliquez sur la zone ombrée pour afficher la zone de filtre.

2. À gauche de la zone de filtre, cliquez sur le bouton Filtrer les éléments de la colonne actuelle par catégorie et propriété.

3. Pour afficher uniquement les nœuds d'un type spécifique, sous Catégories, cliquez sur les types voulus.

4. Pour afficher uniquement les nœuds ayant des propriétés spécifiques, sous Propriétés, cliquez sur les propriétés voulues.

5. Lorsque vous avez terminé, cliquez sur OK.

   La colonne actuelle affiche uniquement les nœuds correspondants. Un filigrane indiquant que la colonne est filtrée s'affiche dans l'angle inférieur droit de la colonne.

Filtrer par type de nœud les nœuds de la colonne suivante

Pour filtrer les nœuds dans la colonne suivante par type de nœud

1. Dans le Navigateur de l'architecture, recherchez la colonne de nœud figurant avant les nœuds que vous voulez afficher, puis sélectionnez les nœuds voulus.

2. Sur le côté droit de la colonne de nœud, cliquez sur la colonne d'action réduite pour la développer.

   Notes

   La colonne d'action apparaît en surbrillance lorsque vous placez le pointeur dessus.

3. Dans la colonne d'action, sous Navigation des nœuds, sélectionnez les types spécifiques de nœuds que vous voulez afficher ensuite.

   Notes

   Pour afficher une union de ces types, sélectionnez plusieurs types.

   Une colonne de nœud apparaît, affichant tous les nœuds correspondants.

Filtrer par type de lien les nœuds de la colonne suivante

Le navigateur de l'architecture organise les types de liens utilisés pour filtrer l'ensemble suivant de nœuds en deux catégories : les liens entrants ou sortants. Ces catégories décrivent la direction du lien par rapport au nœud actuellement sélectionné. Un lien sortant pointe à partir du nœud actuellement sélectionné vers le nœud connexe suivant. Un lien entrant pointe à partir du nœud connexe précédent vers le nœud actuellement sélectionné. Lorsque vous sélectionnez un type de lien sortant, le navigateur de l'architecture affiche le niveau suivant de nœuds connexes. Lorsque vous sélectionnez un type de lien entrant, le navigateur de l'architecture affiche le niveau précédent de nœuds connexes.

Par exemple, si vous sélectionnez un nœud de classe et le type de lien Contient sortant, le navigateur de l'architecture affiche les nœuds contenus dans le nœud de classe. Si vous sélectionnez le type de lien Contenu par entrant pour ce nœud de classe, les nœuds contenant cette classe, tels que les espaces de noms, les fichiers de classe et les projets, s'affichent.

Pour filtrer les nœuds dans la colonne suivante par type de lien

1. Dans le Navigateur de l'architecture, recherchez la colonne de nœud figurant avant les nœuds que vous voulez afficher, puis sélectionnez les nœuds voulus.

2. Sur le côté droit de la colonne de nœud, cliquez sur la colonne d'action réduite pour la développer.

   Notes

   La colonne d'action apparaît en surbrillance lorsque vous placez le pointeur dessus.

3. Dans la colonne d'action, sélectionnez l'un des éléments suivants :

   • Pour afficher les nœuds connexes qui se trouvent au niveau suivant, sous Navigation sortante, sélectionnez les types de liens voulus.

   • Pour afficher les nœuds connexes qui se trouvent au niveau précédent, sous Navigation entrante, sélectionnez les types de liens voulus.

     Notes

     Pour afficher une union de ces types, sélectionnez plusieurs types.

   La colonne suivante apparaît, affichant tous les nœuds correspondants.

Regroupement des nœuds par conteneur ou valeur de propriété

Dans le navigateur de l'architecture, vous pouvez créer des groupes de nœuds en fonction de leurs relations contenant-contenu existantes ou de leurs valeurs de propriété. Si le regroupement est possible, une liste de nouveaux nœuds de groupe apparaît lorsque vous terminez cette tâche.

Lorsque vous créez un graphique à partir de ces groupes dans le navigateur de l'architecture, vous pouvez employer la commande Afficher tout en tant que groupes pour organiser les nœuds liés en groupes. Pour plus d'informations, consultez les rubriques suivantes :

• Comment : générer des graphiques de dépendance pour le code .NET

• Comment : parcourir des documents de graphique et y accéder

Vous pouvez également utiliser des groupes pour organiser des nœuds sur un graphique existant. Pour plus d'informations, consultez Comment : modifier et personnaliser des documents de graphique.

Pour regrouper des nœuds par conteneur ou valeur de propriété

1. Dans le Navigateur de l'architecture, recherchez la colonne de nœud qui contient les nœuds à regrouper. Pour sélectionner tous les éléments présents dans la colonne, appuyez sur CTRL+A.

2. Sur le côté droit de la colonne de nœud, cliquez sur la colonne d'action réduite pour la développer.

   Notes

   La colonne d'action apparaît en surbrillance lorsque vous placez le pointeur dessus.

3. Dans la colonne d'action, sous Regroupement :

   Cliquer sur	Puis
   Grouper par conteneurs pour afficher tous les groupes disponibles	Pour afficher les nœuds figurant dans ces groupes, sélectionnez des groupes. La colonne suivante affiche les nœuds figurant dans les groupes sélectionnés.
   Grouper par propriétés pour afficher toutes les propriétés disponibles	Sélectionnez les propriétés que vous voulez utiliser en tant que groupes. La colonne suivante affiche les groupes organisés par valeur de propriété. Pour afficher les nœuds ayant des valeurs de propriété spécifiques, sélectionnez des groupes de valeurs de propriété. Le nombre de groupes affichés et leur genre dépendent des types des valeurs de propriété : Valeurs booléennes : True et False Valeurs entières : quatre groupes qui divisent la plage de valeurs en quartiles égaux. Valeurs de chaîne : un groupe s'affiche pour chaque valeur de chaîne unique et les nœuds sont répartis dans chaque groupe selon leur valeur de propriété particulière. Ce regroupement s'avère particulièrement utile lorsque la propriété sélectionnée a la même valeur de chaîne pour plusieurs nœuds. Par exemple, si vous sélectionnez une propriété ayant une valeur de chaîne unique pour chaque nœud, vous obtiendrez un groupe par nœud.

Actualiser les résultats de votre navigation

Vous devez actualiser manuellement le navigateur de l'architecture pour afficher toutes les modifications apportées au code ou à la solution.

Pour actualiser le navigateur de l'architecture

1. Dans le Navigateur de l'architecture, recherchez la colonne de nœud figurant avant la colonne que vous voulez actualiser.

2. Dans la colonne actuelle, sélectionnez les nœuds associés aux nœuds mis à jour.

   Une autre colonne de nœud contenant la liste de nœuds actualisée s'affiche.

Enregistrer votre session de navigation sous forme de requête

Vous pouvez enregistrer votre session de navigation dans le navigateur de l'architecture sous forme de requête ou en tant que fichier Directed Graph Query Language (.dgql). Vous pouvez enregistrer une requête sur le disque pour une utilisation ultérieure ou générer des graphiques en mode batch à l'aide de l'outil GraphCmd.exe. Pour plus d'informations sur la génération de documents de graphique en mode batch et DGQL, consultez Comment : générer des graphiques de dépendance pour le code .NET.

Pour enregistrer votre session de navigation

1. Sous la barre de titre du Navigateur de l'architecture, cliquez sur Enregistrer la requête.

2. Dans la boîte de dialogue Enregistrer sous, nommez la requête et enregistrez-la sous forme de fichier .dgql dans le dossier Requêtes local, à l'emplacement suivant :

   …\Mes documents\Visual Studio 2010\ArchitectureExplorer\Requêtes

   Notes

   Pour afficher votre requête dans le navigateur de l'architecture, vous devez enregistrer le fichier .dgql dans le dossier Requêtes ou l'ajouter à votre solution. Pour plus d'informations, consultez Rechercher des requêtes enregistrées.

Rechercher des requêtes enregistrées

Vous pouvez utiliser le navigateur de l'architecture pour rechercher des fichiers de requête (.dgql) lorsque vous les ajoutez à votre solution Visual Studio ou les enregistrez dans le dossier Requêtes local suivant : …\Mes documents\Visual Studio 2010\ArchitectureExplorer\Requêtes. Ce dossier contient également des requêtes prédéfinies fréquemment utilisées. 

Pour plus d'informations sur l'enregistrement de votre session de navigation dans le navigateur de l'architecture sous forme de requête, consultez Enregistrement de votre session de navigation.

Requêtes dans votre solution

Pour rechercher des requêtes dans votre solution

1. Dans le menu Affichage, cliquez sur Navigateur de l'architecture.

2. Dans la première colonne, sous Requêtes DGQL enregistrées, cliquez sur Dans Ma solution pour afficher une colonne de fichiers de requête (.dgql).

3. Dans la colonne de fichiers de requête, cliquez sur un fichier de requête.

   Une autre colonne apparaît, affichant les nœuds de la requête sélectionnée.

4. Sélectionnez un ou plusieurs nœuds pour afficher la colonne suivante contenant les nœuds connexes. Pour sélectionner tous les nœuds dans la colonne actuelle, appuyez sur CTRL+A.

5. Répétez l'étape 4 jusqu'à ce que vous trouviez les nœuds souhaités.

Pour rechercher des requêtes dans le dossier Requêtes local

1. Dans le menu Affichage, cliquez sur Navigateur de l'architecture.

2. Dans la première colonne, sous Requêtes DGQL enregistrées, cliquez sur Dans des dossiers pour afficher une liste de fichiers de requête (.dgql).

   Le tableau suivant répertorie les requêtes prédéfinies que vous pouvez utiliser pour explorer des éléments de votre solution :

   Nom du fichier de requête	Affiche
   All Assembly References.dgql	Tous les assemblys référencés par la solution. À partir des résultats de la requête, vous pouvez générer un graphique qui affiche les dépendances entre ces assemblys. Pour plus d'informations, consultez Comment : générer des graphiques de dépendance pour le code .NET.
   All Output Assemblies.dgql	Liste plate de tous les assemblys de sortie dans la solution sans liens de dépendance. À partir des résultats de la requête, vous pouvez générer un graphique de dépendance pour les assemblys sélectionnés : Dans la colonne actuelle, sélectionnez les assemblys que vous voulez explorer. Le long du côté droit de la colonne active, cliquez sur la colonne d'action réduite pour la développer. Remarque La colonne d'action apparaît en surbrillance lorsque vous placez le pointeur dessus. Dans la colonne d'action, sous Commandes, cliquez sur Graphique standard.
   All Project References.dgql	Toutes les références entre les projets de la solution. À partir des résultats de la requête, vous pouvez générer un graphique qui présente les références entre ces projets. Pour plus d'informations, consultez Comment : générer des graphiques de dépendance pour le code .NET.
   All Projects.dgql	Liste plate de tous les projets de la solution. Si votre solution inclut des dossiers de solution, cette liste diffère de celle qui s'affiche lorsque vous cliquez sur Affichage de solutions dans le navigateur de l'architecture.
   Constructors.dgql	Liste plate de toutes les méthodes de constructeur
   Inheritance Graph.dgql	Tous les types de la solution ayant les relations suivantes : Hérite de Implémente À partir des résultats de la requête, vous pouvez générer un graphique qui présente les relations d'héritage entre ces types. Pour plus d'informations, consultez Comment : générer des graphiques de dépendance pour le code .NET.
   Public Classes.dgql	Liste plate de toutes les classes publiques de la solution
   Virtual Members.dgql	Liste plate de tous les membres virtuels de la solution

3. Dans la colonne de fichiers de requête, cliquez sur un fichier de requête.

   Une colonne de nœud apparaît, affichant les nœuds de la requête sélectionnée.

4. Dans la colonne de nœud, sélectionnez un ou plusieurs nœuds pour afficher la colonne contenant les nœuds connexes. Pour sélectionner tous les nœuds dans la colonne actuelle, appuyez sur CTRL+A.

5. Répétez l'étape 4 jusqu'à ce que vous trouviez les nœuds souhaités.

Voir aussi

Concepts

Visualisation du code existant