Diagramas de dependencia: Referencia
En Visual Studio, puede usar un diagrama de dependencias para visualizar la arquitectura lógica de alto nivel del sistema. Un diagrama de dependencias organiza los artefactos físicos del sistema en grupos lógicos abstractos denominados capas. Estas capas describen las tareas principales que realizan los artefactos o los componentes principales del sistema. Cada capa también puede contener capas anidadas que describen tareas más detalladas.
Para ver qué ediciones de Visual Studio admiten esta característica, consulte Compatibilidad de ediciones con las herramientas de arquitectura y modelado.
Nota
Se admiten diagramas de dependencias para proyectos de .NET Core a partir de la versión 16.2 de Visual Studio 2019.
Se pueden especificar las dependencias planeadas o existentes entre las capas. Estas dependencias, que se representan como flechas, indican qué capas pueden usar o usan actualmente la funcionalidad representada por otras capas. Al organizar el sistema en capas que describen roles y funciones distintos, un diagrama de dependencias le ayudará a entender, reutilizar y mantener el código más fácilmente.
Use un diagrama de dependencias para realizar las siguientes tareas:
Comunicar la arquitectura lógica existente o planeada del sistema.
Detectar conflictos entre el código existente y la arquitectura planeada.
Visualizar el impacto de los cambios en la arquitectura planeada al refactorizar, actualizar o desarrollar el sistema.
Reforzar la arquitectura planeada durante el desarrollo y el mantenimiento del código incluyendo la validación en las operaciones de protección y compilación.
En este tema se describen los elementos que puede usar en un diagrama de dependencias. Para más información sobre cómo crear y dibujar diagramas de dependencias, consulte Diagramas de dependencias: Instrucciones. Para más información sobre los patrones de capas, visite el sitio Patrones y procedimientos.
Lectura de diagramas de dependencias
En la tabla siguiente se describen los elementos que puede usar en un diagrama de dependencias.
| Forma | Element | Descripción |
|---|---|---|
| 1 | Nivel | Grupo lógico de artefactos físicos del sistema. Estos artefactos pueden ser espacios de nombres, proyectos, clases, métodos, etc. Para ver los artefactos que están vinculados a una capa, abra el menú contextual de la capa y elija Ver vínculos para abrir el Explorador de capas. Para más información, consulte Explorador de capas. - Dependencias de espacios de nombres prohibidos: Especifica qué artefactos asociados a esta capa no pueden depender de los espacios de nombres especificados. - Espacios de nombres prohibidos: Especifica qué artefactos asociados a esta capa no deben pertenecer a los espacios de nombres especificados. - Espacios de nombres requeridos: Especifica qué artefactos asociados a esta capa deben pertenecer a uno de los espacios de nombres especificados. |
| 2 | Dependencia | Indica que una capa puede usar la funcionalidad de otra capa, pero no viceversa. - Dirección: Especifica la dirección de la dependencia. |
| 3 | Dependencia bidireccional | Indica que una capa puede usar la funcionalidad de otra capa, y viceversa. - Dirección: Especifica la dirección de la dependencia. |
| 4 | Comment | Use esta opción para agregar notas generales al diagrama o elementos del diagrama. |
| 5 | Vínculo de comentario | Se usa para vincular comentarios a elementos del diagrama. |
Explorador de capas
Puede vincular cada capa a artefactos de la solución, como proyectos, clases, espacios de nombres, archivos de proyecto y otros elementos del software. El número de una capa muestra la cantidad de artefactos vinculados a ella. Sin embargo, cuando lea el número de artefactos de una capa, recuerde lo siguiente:
Si una capa se vincula a un artefacto que contiene otros artefactos, pero no se vincula directamente a estos otros artefactos, el número incluye únicamente el artefacto vinculado. Sin embargo, los demás artefactos se incluyen para el análisis durante la validación de capas.
Por ejemplo, si una capa está vinculada a un solo espacio de nombres, el número de artefactos vinculados es 1, aunque el espacio de nombres contenga clases. Si la capa tiene también vínculos a cada clase del espacio de nombres, el número incluirá las clases vinculadas.
Si una capa contiene otras que están vinculadas a artefactos, la capa contenedora también está vinculada a esos artefactos, incluso aunque el número de la capa contenedora no los incluya.
Para obtener más información sobre cómo vincular capas y artefactos, vea:
Examen de los artefactos vinculados
En el diagrama de dependencias, abra el menú contextual de una o varias capas y, a continuación, elija Ver vínculos.
Se abre el Explorador de capas, que muestra los artefactos que están vinculados a las capas seleccionadas. El Explorador de capas tiene una columna que muestra cada una de las propiedades de los vínculos de artefacto.
Nota
Si no puede ver todas estas propiedades, expanda la ventana Explorador de capas.
| Columna del Explorador de capas | Descripción |
|---|---|
| Categorías | Tipo de artefacto, como una clase, espacio de nombres, archivo de código fuente, etcétera |
| Nivel | Capa que se vincula al artefacto |
| Admite validación | Si es True, el proceso de validación de capas puede comprobar que el proyecto se ajusta a las dependencias que tengan como origen o destino este elemento. Si es False, el vínculo no participa en el proceso de validación de capas. Para más información, consulte Diagramas de dependencias: Instrucciones. |
| Identificador | Referencia al artefacto vinculado |