Visualiser des dépendances de code sur les graphiques de dépendance

• Comment est-ce-que j'obtiens démarré ?

• Consulter les dépendances dans votre code

• Graphiques de dépendance de partage

• Générer des graphiques pour le traitement par lots

• Dépannage

• Obtenir une vue d'ensemble de votre solution: Dans le menu Architecture , choisissez Générer un graphique de dépendance, Pour la solution.

  Vous obtenez un graphique qui affiche les assemblys de niveau supérieur. Vous pouvez maintenant explorer ces assemblys en développant les. Déplacez le pointeur de la souris sur un assembly, puis sélectionnez le bouton en forme de chevron (^) lorsqu'il apparaît. Effectuez la même opération pour les espaces de noms, types, des membres continuent d'explorer votre code.

  

  Pour afficher les dépendances entre groupes, choisissez un élément sur le graphique.

  

  Pour plus d'informations, consultez l' Obtenir une vue d'ensemble de votre solution. Vous pouvez également exécuter des analyseurs pour rechercher des problèmes potentiels dans votre code. Consultez Rechercher des problèmes potentiels dans le code des graphiques de dépendance.

• Affichez les dépendances spécifiques dans votre solution: dans Explorateur de solutions, éléments choisis qui vous intéressent. Vous pouvez sélectionner des projets, des références d'assembly, les dossiers, les fichiers, les types, et leurs membres. Pour rechercher un élément spécifique, utilisez la zone de recherche Explorateur de solutions .

  Dans la barre d'outils Explorateur de solutions , choisissez Créez un document de graphique.

  - ou -

  Faites glisser les éléments Explorateur de solutions à un graphique existant.

  Conseil
  Pour créer un graphique vide, dans le menu Fichier , choisissez Nouveau, Fichier, Document de graphique orienté. Pour comprendre la hiérarchie parente pour vos éléments, maintenez enfoncée la touche CTRL pendant que vous faites glisser des éléments.

  Vous obtenez un graphique qui affiche les éléments sélectionnés. Vous pouvez maintenant explorer ces éléments en développant les. Déplacez le pointeur de la souris sur un élément, puis sélectionnez le bouton en forme de chevron (^) lorsqu'il apparaît.

  Pour plus d'informations, consultez l' Affichez les dépendances spécifiques dans votre solution. Vous pouvez également exécuter des analyseurs pour rechercher des problèmes potentiels dans votre code. Consultez Rechercher des problèmes potentiels dans le code des graphiques de dépendance.

Les graphiques de dépendance offrent un moyen visuelle pour examiné le code et de comprendre ses dépendances sans devoir examiner des fichiers et des lignes de code. Vous pouvez consulter des éléments et des relations comme uniquement les nœuds et liens, ou des flèches. Par exemple, supposez que vous avez une révision du code à exécuter. Vous avez un jeu de fichiers qui contiennent des modifications en attente. Vous pouvez visualiser le code et les dépendances pour ces modifications en créant un graphique de dépendance à partir de ces fichiers. Consultez l' Affichez les dépendances spécifiques dans votre solution.

Par défaut, les relations de conteneur sont représentées sous forme de groupes, que vous pouvez développer et réduire.

Conseil
Le bouton Récupérer à nouveau les enfants vous permet de récupérer les membres du groupe qui existent dans le code mais n'apparaît pas sur le graphique. Nous avons également appliquer un style différent des liens d'appels vous pouvez le voir plus facilement. Consultez Modifier et personnaliser des graphiques de dépendance.

Vous pouvez également afficher des relations de conteneur comme liens. Ouvrez le menu contextuel du graphique, choisissez Groupe, Activer le regroupement:

Vous pouvez également exécuter des analyseurs pour rechercher des problèmes potentiels dans votre code. Consultez Rechercher des problèmes potentiels dans le code des graphiques de dépendance.

Lorsque vous générez un graphique de dépendance la première fois, Visual Studio clés toutes les dépendances qu'il recherche. Ce processus peut prendre un certain temps, particulièrement pour les grands solutions ou graphiques avec de nombreux liens. Toutefois, l'index améliore les performances des opérations ultérieures. Si les modifications du code, Visual Studio réindexe uniquement le code mis à jour.

Si vous ne souhaitez pas attendre le graphique pour terminer la génération, vous pouvez annuler cette étape à tout moment et essayer les suggestions suivantes :

• Graphique uniquement les dépendances qui vous intéressent.

• Avant de générer le graphique pour une solution entière, réduisez la portée de la solution.

Bien que Visual Studio puisse fonctionner avec 1 go de mémoire, nous avons recommandé que votre ordinateur ont au moins 2 go de mémoire pour éviter les longues attend pendant que Visual Studio crée l'index de code et génère le graphique.

Remarque

Visual Studio génère un graphique si au moins un projet est correctement généré. Il affiche uniquement les dépendances du code qui est correctement généré. Si des erreurs de build se produisent pour certains composants, les erreurs pour ces composants s'affichent sur le graphique. Assurez -vous que les builds d'un composant réellement et avez des dépendances sur avant de prenniez des décisions architecturales basées sur le graphique. Cela peut prendre plus de temps pour créer des graphiques ou d'ajouter des éléments à un graphique de l'explorateur de solutions lorsque la propriété de Copier dans le répertoire de sortie d'un élément de projet est définie à Toujours copier. Cela peut rendre régénérer des problèmes avec les générations incrémentielles et Visual Studio le projet à chaque fois. Pour améliorer les performances, remplacez la propriété par Copier si plus récent ou PreserveNewest. Consultez Builds incrémentielles.

• Obtenir une vue d'ensemble de votre code

• Affichez les dépendances spécifiques dans votre code

• Affichez les dépendances entre C ou les fichiers sources et les fichiers d'en-tête C++

• Générer des graphiques pour le traitement par lots à l'aide de GraphCmd.exe

Conseil

Pour générer des graphiques plus complètes pour les projets C++, l'option du compilateur d'informations de parcourir (/FR) doit être définie sur ces projets. Sinon, un message vous invite à définir cette option. Si le message s'affiche, vous pouvez définir l'option pour que le graphique actuellement en choisissant OK, ou vous pouvez définir l'option et masquer le message pour tous les graphiques suivants. Pour que le message s'affiche pour les graphiques suivants, définir la clé de Registre suivante à 0 ou supprimer la clé : HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\11.0\NativeProvider : AutoEnableSbr Consultez /FR, /Fr (Créer un fichier .sbr).

Vous pouvez créer un graphique de dépendance pour votre solution entière ou pour les assemblys ou des fichiers binaires.

Obtenir une vue d'ensemble de votre solution

Obtenir une vue d'ensemble des assemblys ou des fichiers binaires

Pour créer un graphique vide

Vous pouvez créer un graphique de dépendance pour des éléments spécifiques dans votre solution ou dans les assemblys et les fichiers binaires.

Affichez les dépendances spécifiques dans votre solution

Affichez les dépendances spécifiques dans les assemblys ou les fichiers binaires

Enregistrez et partager le graphique avec d'autres utilisateurs Visual Studio

Exportez le graphique comme une image vous pouvez le copier dans d'autres applications, telles que Microsoft Word ou PowerPoint

Exportez le graphique en tant que fichier XPS vous pouvez le voir dans des visionneuses XML ou XAML comme Internet Explorer

Vous pouvez générer des documents de graphiques (.dgml) par lots à l'aide de l'outil en ligne de commande des GraphCmd.exe . Par exemple, vous pouvez exécuter l'outil après chaque build pour rechercher les dépendances qui ont changé entre les builds. Cet outil se trouve dans le dossier suivant : C:\Program Files\Microsoft Visual Studio 11.0\Common7\IDE.

Remarque
GraphCmd.exe prend en charge uniquement le code.NET et génère des informations sur les dépendances uniquement pour les assemblys ou des fichiers .dgml, pas le code source dans une solution Visual Studio ou des fichiers projet. GraphCmd.exe s'exécute en dehors de Visual Studio, donc la prise en charge des actions dans les requêtes DGQL est limité.

Utilisez la syntaxe suivante de GraphCmd.exe :

GraphCmd -? -all -exceptions -input File_Name -query File_Name -exec "DGQL_Statement" -output File_Name -path alias=path

Conseil
Vous pouvez spécifier les options suivantes plusieurs fois : -input, -query, -exec et -path.

Le tableau suivant décrit les options de GraphCmd.exe :

GraphCmd -output MyGeneratedGraph.dgml -path "MyPathAlias=C:\Program Files\..."

Alias pour les chemins d'accès fréquemment utilisés

<Paths>
   <Path Id="MyPathAlias" Value="C:\...\..." />
</Paths>

<Nodes>
   <Node Id="MyNode" Reference="$(MyPathAlias)MyDocument.txt" />
</Nodes>
<Properties>
   <Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" />
</Properties>

Fonctionnement du langage DGQL (Directed Graph Query Language)

Le langage DGQL est un langage de requêtes simplifié que vous pouvez utiliser pour générer du code DGML. Une instruction DGQL suit un modèle alternant une sélection de nœuds et des actions, de sorte que chaque sélection de nœuds crée l'entrée de l'action suivante, dont la sortie devient l'entrée de la sélection de nœuds suivante, et ainsi de suite.

Le format d'une instruction DGQL est le suivant :

<node selection> / <action> / <node selection> / <action> / ...

Le tableau suivant décrit la syntaxe DGQL utilisée pour sélectionner des nœuds :

*	Sélectionner tous les nœuds.
+ "text"	Sélectionner tous les nœuds qui contiennent la chaîne "text".
+ Id.Equals("text")	Sélectionner tous les nœuds pour lesquels Id est égal à la chaîne "text".
+ Background.Contains("text")	Sélectionner tous les nœuds pour lesquels l'attribut Background a une valeur qui contient la chaîne "text".
+ "text1" + "text2" + ...	Sélectionner tous les nœuds qui correspondent à "text1" ou "text2".
+ MyProperty="True"	Sélectionner tous les nœuds qui possèdent une propriété nommée MyProperty ayant la valeur "True".
- Label.Contains("text")	Sélectionner tous les nœuds, sauf ceux qui possèdent un attribut Label qui contient (Contains) la chaîne "text".
+ Category.Is("MyCategory")	Sélectionner tous les nœuds qui possèdent une catégorie nommée MyCategory ou qui héritent de MyCategory.

Le tableau suivant décrit des exemples d'actions directes pouvant être exécutées sur les nœuds sélectionnés :

Exemple d'action	Description
Microsoft.Contains	Retourner tous les nœuds qui sont contenus par les nœuds d'entrée. Vous pouvez remplacer Contains par une autre catégorie de lien.
Microsoft.Open	Ouvrir le code source des nœuds d'entrée. Remarque Fonctionne uniquement dans Visual Studio.
Microsoft.AllOutBoundLinks	Retourner tous les nœuds qui sont la cible d'un lien sortant à partir des nœuds d'entrée.
Microsoft.AllInboundLinks	Retourner tous les nœuds qui sont l'extrémité source d'un lien vers les nœuds d'entrée.
Microsoft.Core.CreateGroupsByProperties	Appeler l'action GroupByProperties.
Microsoft.AllNodes	Retourner tous les nœuds figurant jusqu'ici dans l'ensemble du graphique.

Les actions pilotées par des données sélectionnent des éléments qui reposent uniquement sur les données figurant dans les nœuds d'entrée et les liens. Lorsque des catégories sont mises en correspondance grâce aux actions pilotées par des données, les catégories héritées sont incluses. Le tableau suivant décrit des exemples d'actions pilotées par des données :

Type	Description
Node:Both:Category	Retourner tous les nœuds qui possèdent la catégorie Category et qui sont reliés aux nœuds d'entrée par un lien qui pointe vers l'une ou l'autre direction.
Link:Both:Category	Retourner tous les nœuds qui sont reliés aux nœuds d'entrée par un lien qui pointe vers l'une ou l'autre direction et qui possèdent la catégorie Category.
Link:Backward:Category	Retourner tous les nœuds qui pointent vers les nœuds d'entrée ayant un lien qui possède la catégorie Category.
Link:Forward:Category	Retourner tous les nœuds qui pointent à partir des nœuds d'entrée ayant un lien qui possède la catégorie Category.

Conseils

• En général, une action « par défaut » est définie pour un ensemble donné de nœuds d'entrée ; celle-ci est automatiquement sélectionnée par le Navigateur de l'architecture. Pour obtenir le même comportement, utilisez une action vide : //

• Comme l'espace blanc n'est pas significatif en langage DGQL, vous pouvez mettre en forme votre requête de telle sorte qu'elle tienne sur une seule ligne si nécessaire. Cela s'avère utile lorsque vous utilisez l'option –exec avec GraphCmd.

• Lorsque vous déboguez du code DGQL, utilisez l'action "Execute Expanded" dans le Navigateur de l'architecture pour afficher chaque étape de la requête et repérer l'étape qui ne produit pas les résultats attendus.

Exemple

L'instruction DGQL suivante exécute une requête décrite dans les étapes ci-dessous :

Copier

+ Id.Equals("Microsoft.Solution.ClassView") / "Microsoft.Solution.ClassView" / * / "Node:Both:CodeSchema_Class" / + CodeSchemaProperty_IsPublic.Equals("True")

1. Sélectionnez le nœud Affichage de classes dans la première colonne Navigateur de l'architecture.

2. Exécutez l'action « Microsoft.Solution.ClassView", qui retourne tous les espaces de noms dans la solution. 

3. Utilisez * pour sélectionner tous les espaces de noms.

4. Sélectionnez tous les nœuds de catégorie CodeSchema_Class, associés à ces espaces de noms par un lien dans un sens ou dans l'autre. Ce seront généralement des liens de relation contenant-contenu.

5. Filtrez les classes résultantes pour ne conserver que celles qui possèdent la propriété CodeSchemaProperty_IsPublic="True".

L'action "Microsoft.Solution.ClassView" est techniquement inutile, car il s'agit de l'action « par défaut » du nœud Affichage de classes. Vous pouvez par conséquent remplacer cette action par // pour simplifier la requête et la mettre en forme sur une seule ligne de la manière suivante :

Copier

+Id.Equals("Microsoft.Solution.ClassView")//*/"Node:Both:CodeSchema_Class"/+CodeSchemaProperty_IsPublic.Equals("True")

Les éléments suivants ne sont pas pris en charge pour le code C et C++ :

• Les types de base n'apparaissent pas sur les graphiques qui incluent la hiérarchie parente.

• La plupart des éléments de menu Afficher sont pas disponibles pour le code C et C++.

Les problèmes suivants peuvent se produire en créant des graphiques de dépendance pour le code C et C++ :

• Parcourir et réorganiser des graphiques de dépendance

• Rechercher des problèmes potentiels dans le code des graphiques de dépendance

• Modifier et personnaliser des graphiques de dépendance