Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Pour visualiser l'architecture logique de haut niveau de votre système logiciel, créez un diagramme dépendency dans Visual Studio. Pour vous assurer que votre code reste cohérent avec cette conception, validez votre code avec un diagramme de dépendances. Vous pouvez créer des diagrammes de dépendances pour les projets Visual C# et Visual Basic. Pour voir quelles éditions de Visual Studio prennent en charge cette fonctionnalité, consultez la prise en charge de l’édition pour les outils d’architecture et de modélisation.
Un diagramme de dépendances vous permet d’organiser Visual Studio éléments de solution en groupes logiques abstraits appelés layers. Vous pouvez utiliser des couches pour décrire les tâches majeures effectuées par ces artefacts ou les composants principaux du système.
Chaque couche peut contenir d’autres couches qui décrivent des tâches plus détaillées. Vous pouvez également spécifier les dépendances prévues ou existantes entre les couches. Ces dépendances, représentées sous forme de flèches, affichent les couches qui utilisent ou peuvent utiliser les fonctionnalités représentées par d’autres couches. Pour maintenir le contrôle architectural du code, affichez les dépendances prévues sur le diagramme, puis validez le code par rapport au diagramme.
Vidéo : Valider vos dépendances d’architecture en temps réel
Créer un diagramme de dépendances
Avant de créer un diagramme de dépendances, vérifiez que votre solution a un projet de modélisation.
Important
N’ajoutez pas, faites glisser ou copiez un diagramme de dépendance existant d’un projet de modélisation vers un autre projet de modélisation ou vers un autre emplacement dans la solution. Cela conserve les références du diagramme d’origine, même si vous modifiez le diagramme. Cela empêche également la validation de couche de fonctionner correctement et peut entraîner d’autres problèmes, tels que des éléments manquants ou d’autres erreurs lorsque vous essayez d’ouvrir le diagramme.
Au lieu de cela, ajoutez un nouveau diagramme de dépendances au projet de modélisation. Copiez les éléments du diagramme source vers le nouveau diagramme. Enregistrez les deux, le projet de modélisation et le nouveau diagramme de dépendances.
Ajouter un nouveau diagramme de dépendances à un projet de modélisation
Note
Les diagrammes de dépendances pour les projets .NET Core sont pris en charge à partir de Visual Studio 2019 version 16.2.
Cliquez avec le bouton droit sur votre projet de modélisation dans Explorateur de solutions, puis sélectionnez Add>New Item.
Dans la fenêtre Ajouter un nouvel élément , sélectionnez Diagramme de validation des dépendances, entrez un nom pour le diagramme en bas de la fenêtre, puis sélectionnez Ajouter.
Glisser-déplacer ou copier-coller à partir d’une carte de code
Générez un mappage de code pour la solution à l’aide du menu Architecture .
Envisagez d’appliquer un filtre De mappage de code pour supprimer les dossiers de solution et les « ressources de test » si vous souhaitez uniquement appliquer des dépendances dans le code de produit.
Sur la carte de code générée, supprimez le nœud « Externe » ou développez-le pour afficher les assemblys externes, selon que vous souhaitez appliquer des dépendances d’espace de noms. Supprimez les assemblages non requis de la carte du code.
Ajoutez un élément de diagramme de validation de dépendance au projet De validation des dépendances dans votre solution.
Sélectionnez tous les nœuds sur la carte de code (utilisez Ctrl + A ou utilisez la sélection de bande en caoutchouc en appuyant sur la touche Maj avant de cliquer, faire glisser et libérer).
Faites glisser-déplacer, ou copiez-collez les éléments sélectionnés dans le nouveau diagramme de validation des dépendances.
Cela montre l’architecture actuelle de l’application. Déterminez ce que vous souhaitez que l’architecture soit et modifiez le diagramme de dépendances en conséquence.
Créer des couches à partir d’artefacts
Vous pouvez créer des couches à partir de Visual Studio éléments de solution, tels que des projets, des fichiers de code, des espaces de noms, des classes et des méthodes. Cela crée automatiquement des liens entre les couches et les éléments, y compris dans le processus de validation de couche.
Vous pouvez lier des couches à des éléments qui ne prennent pas en charge la validation, telles que les documents Word ou les présentations PowerPoint. Cela vous permet d’associer une couche à des spécifications ou des plans. Vous pouvez également lier des couches à des fichiers dans des projets partagés entre plusieurs applications, mais le processus de validation n’inclut pas ces couches, qui apparaissent avec des noms génériques tels que « Couche 1 » et « Couche 2 ».
Pour voir si un élément lié prend en charge la validation, ouvrez l’Explorateur de couches et examinez la propriété Supports Validation de l’élément. Consultez Gestion des liens vers des artefacts.
| Pour | Suivez ces étapes |
|---|---|
| Créer une couche pour un seul artefact |
Important: Le fait de faire glisser des fichiers binaires vers le diagramme de dépendances n’ajoute pas automatiquement leurs références au projet de modélisation. Ajoutez manuellement les fichiers binaires que vous souhaitez valider au projet de modélisation. Pour ajouter des fichiers binaires au projet de modélisation
|
| Créer une couche unique pour tous les artefacts sélectionnés | Faites glisser tous les artefacts vers le diagramme de dépendances en même temps. Une couche apparaît sur le diagramme et est liée à tous les artefacts. |
| Créer une couche pour chaque artefact sélectionné | Appuyez longuement sur la touche Maj pendant que vous faites glisser tous les artefacts vers le diagramme de dépendances en même temps. Note: Si vous utilisez la touche Maj pour sélectionner une plage d’éléments, relâchez la clé après avoir sélectionné les artefacts. Appuyez longuement dessus lorsque vous faites glisser les artefacts vers le diagramme. Une couche pour chaque artefact apparaît sur le diagramme et est liée à chaque artefact. |
| Ajouter un artefact à une couche | Faites glisser l’artefact vers la couche. |
| Créer une couche non dissociée | Dans la boîte à outils, développez la section Diagramme de dépendances , puis faites glisser une couche vers le diagramme de dépendances. Pour ajouter plusieurs couches, double-cliquez sur l’outil. Lorsque vous avez terminé, choisissez l’outil Pointeur ou appuyez sur la touche Échap. - ou - Ouvrez le menu contextuel du diagramme de dépendances, choisissez Ajouter, puis choisissez Calque. |
| Créer des couches imbriquées | Faites glisser une couche existante vers une autre couche. - ou - Ouvrez le menu contextuel d’une couche, choisissez Ajouter, puis couche. |
| Créer une couche qui contient deux couches ou plus existantes | Sélectionnez les couches, ouvrez le menu contextuel de votre sélection, puis choisissez Grouper. |
| Modifier la couleur d’une couche | Définissez sa propriété Color sur la couleur souhaitée. |
| Spécifiez que les artefacts associés à une couche ne doivent pas appartenir aux espaces de noms spécifiés | Tapez les espaces de noms dans la propriété Espaces de noms interdits de la couche. Utilisez un point-virgule ( ;) pour séparer les espaces de noms. |
| Spécifiez que les artefacts associés à une couche ne peuvent pas dépendre des espaces de noms spécifiés | Tapez les espaces de noms dans la propriété Dépendances d’espaces de noms interdits de la couche. Utilisez un point-virgule ( ;) pour séparer les espaces de noms. |
| Spécifiez que les artefacts associés à une couche doivent appartenir à l’un des espaces de noms spécifiés | Tapez l’espace de noms dans la propriété Espaces de noms obligatoires de la couche. Utilisez un point-virgule ( ;) pour séparer les espaces de noms. |
Le nombre sur une couche indique le nombre d’artefacts liés à la couche. Toutefois, lors de la lecture de ce nombre, n’oubliez pas :
Si une couche lie à un artefact qui contient d’autres artefacts, mais que la couche ne lie pas directement aux autres artefacts, le nombre inclut uniquement l’artefact lié. Toutefois, les autres artefacts sont inclus pour l’analyse pendant la validation de couche.
Par exemple, si une couche est liée à un espace de noms unique, le nombre d’artefacts liés est 1, même si l’espace de noms contient des classes. Si la couche contient également des liens vers chaque classe de l’espace de noms, le nombre inclut les classes liées.
Si une couche contient d’autres couches liées à des artefacts, la couche conteneur est également liée à ces artefacts, même si le nombre sur la couche conteneur n’inclut pas ces artefacts.
Gérer les liens entre les couches et les artefacts
Dans le diagramme de dépendances, ouvrez le menu contextuel de la couche, puis choisissez Afficher les liens.
L’Explorateur de couches affiche les liens d’artefact pour la couche sélectionnée.
Utilisez les tâches suivantes pour gérer ces liens :
| Pour | Dans l’Explorateur de couches |
|---|---|
| Supprimer le lien entre la couche et un artefact | Ouvrez le menu contextuel du lien d’artefact, puis choisissez Supprimer. |
| Déplacer le lien d’une couche vers un autre | Faites glisser le lien d’artefact vers une couche existante sur le diagramme. - ou - 1. Ouvrez le menu contextuel du lien d’artefact, puis choisissez Couper. 2. Dans le diagramme de dépendances, ouvrez le menu contextuel de la couche, puis choisissez Coller. |
| Copier le lien d’une couche vers un autre | 1. Ouvrez le menu contextuel du lien d’artefact, puis choisissez Copier. 2. Dans le diagramme de dépendances, ouvrez le menu contextuel de la couche, puis choisissez Coller. |
| Créer une couche à partir d’un lien d’artefact existant | Faites glisser le lien d’artefact vers une zone vide sur le diagramme. |
| Vérifiez qu’un artefact lié prend en charge la validation par rapport au diagramme de dépendances. | Recherchez le lien d’artefact dans la colonne Prend en charge la validation. |
Rétro-ingénierie des dépendances existantes
Une dépendance existe partout où un artefact associé à une couche a une référence à un artefact associé à une autre couche. Par exemple, une classe d’une couche déclare une variable qui a une classe dans une autre couche. Vous pouvez réaliser une ingénierie inverse des dépendances existantes pour les artefacts liés à des couches du diagramme.
Note
Les dépendances ne peuvent pas être conçues à l’inverse pour certains types d’artefacts. Aucune dépendance ne sera rétro-ingéniée depuis ou vers une couche liée à un fichier texte. Pour voir quels artefacts ont des dépendances que vous pouvez inverser,ouvrez le menu contextuel pour une ou plusieurs couches, puis choisissez Afficher les liens. Dans l’Explorateur de couches, examinez la colonne Supports Validation . Les dépendances des artefacts pour lesquels cette colonne affiche la valeur False ne feront pas l’objet d’une ingénierie à rebours.
Sélectionnez une ou plusieurs couches, ouvrez le menu contextuel d’une couche sélectionnée, puis choisissez Générer des dépendances.
Si vous voyez certaines dépendances qui ne doivent pas exister, vous pouvez modifier ces dépendances pour les aligner sur la conception prévue.
Modifier les couches et les dépendances pour afficher la conception prévue
Pour décrire les modifications que vous envisagez d’apporter à votre système ou à l’architecture prévue, modifiez le diagramme de dépendances :
| Pour | Effectuez ces étapes |
|---|---|
| Modifier ou restreindre la direction d’une dépendance | Définissez sa propriété Direction . |
| Créer des dépendances | Utilisez les outils de dépendance et de dépendance bidirectionnelle . Pour dessiner plusieurs dépendances, double-cliquez sur l’outil. Lorsque vous avez terminé, choisissez l’outil Pointeur ou appuyez sur la touche Échap. |
| Spécifiez que les artefacts associés à une couche ne peuvent pas dépendre des espaces de noms spécifiés | Tapez les espaces de noms dans la propriété Dépendances d’espaces de noms interdits de la couche. Utilisez un point-virgule ( ;) pour séparer les espaces de noms. |
| Spécifiez que les artefacts associés à une couche ne doivent pas appartenir aux espaces de noms spécifiés | Tapez les espaces de noms dans la propriété Espaces de noms interdits de la couche. Utilisez un point-virgule ( ;) pour séparer les espaces de noms. |
| Spécifiez que les artefacts associés à une couche doivent appartenir à l’un des espaces de noms spécifiés | Tapez l’espace de noms dans la propriété Espaces de noms obligatoires de la couche. Utilisez un point-virgule ( ;) pour séparer les espaces de noms. |
Modifier l’apparence des éléments dans le diagramme
Vous pouvez modifier la taille, la forme, la couleur et la position des couches ou la couleur des dépendances en modifiant leurs propriétés.
Découvrir des modèles et des dépendances sur une carte de code
Lors de la création de diagrammes de dépendances, vous pouvez également créer des mappages de code. Ces diagrammes peuvent vous aider à découvrir des modèles et des dépendances pendant que vous explorez le code. Utilisez Explorateur de solutions, l’affichage de classes ou l’Explorateur d’objets pour explorer des assemblys, des espaces de noms et des classes, qui correspondent souvent bien aux couches existantes. Pour plus d’informations sur les mappages de code, consultez :
Utiliser des mappages de code pour déboguer vos applications
Rechercher des problèmes potentiels à l’aide d’analyseurs de mappage de code