Editar y personalizar gráficos de dependencias

Puede editar gráficos de dependencias sin afectar al código subyacente.Esto es útil cuando desea centrarse en los elementos clave o para comunicar ideas sobre el código.Por ejemplo, para resaltar áreas interesantes, puede seleccionar nodos y filtrarlos, cambiar el estilo de los nodos y vínculos, ocultar o los nodos de cancelación, y organizar los nodos mediante propiedades, categorías, o grupos.

Puede personalizar un gráfico aún más editando el archivo Directed Graph markup language de gráfico (.dgml).Por ejemplo, puede modificar elementos para especificar estilos personalizados, asignar propiedades y categorías a nodos y vínculos, o vincular nodos a elementos, como documentos, direcciones URL, u otros dibujos.

[!NOTA]

Visual Studio limpia los atributos y elementos de DGML que no cuando se guarda el archivo .dgml.También crea automáticamente los elementos de nodo cuando se agregan los nuevos vínculos manualmente. Cuando se guarda el archivo .dgml, cualquier atributo agregado a un elemento puede reorganizar en orden alfabético.Para obtener más información sobre los elementos de DGML, vea Introducción a Directed Graph Markup Language (DGML).

Requisitos

• Visual Studio Ultimate, Visual Studio Premium o Visual Studio Profesional.

  Para crear gráficos de dependencias, debe tener Visual Studio Ultimate.Vea Visualizar dependencias de código en gráficos de dependencias.

En este tema

• Nodos o vínculos seleccionar

• Cambie el nombre de los nodos o vínculos

• Ocultar o mostrar nodos y vínculos

• Agregue los nodos y vínculos

• Agregue comentarios en el gráfico

• Elimine los nodos

• Agrupe los nodos

• Combinar gráficos

• Cambiar el estilo del gráfico

• Cambie el nodo o vincule el estilo

• Copiar estilos de un gráfico a otro

• Asignar propiedades a nodos y vínculos

• Asignar categorías a nodos y vínculos

• Vincular elementos a nodos o vínculos

• Crear alias para rutas de acceso usadas con frecuencia

Nodos o vínculos seleccionar

Cambie el nombre de los nodos o vínculos

• Seleccione el nodo o vínculo.Presione F2.Cuando aparezca el cuadro de edición, cambie el nombre del nodo o vínculo.

  Si la etiqueta está visible, seleccione la etiqueta.

Ocultar o mostrar nodos y vínculos

Al ocultar los nodos se evita que participen en algoritmos de diseño.De forma predeterminada, los vínculos entre grupos se ocultan.Los vínculos entre grupos son vínculos individuales que conectan nodos entre diferentes grupos.Cuando los grupos se contraen, el gráfico agrega todos los vínculos entre grupos a los vínculos individuales que hay entre los grupos.Cuando se expanden los grupos y se seleccionan los nodos que hay dentro de un grupo, los vínculos entre grupos aparecen y muestran las dependencias que existen dentro de ese grupo.

Precaución
Antes de compartir un gráfico creado en Visual Studio Ultimate con los que usen Visual Studio Premium o Visual Studio Professional, asegúrese de revelar cualquier nodo o vínculo entre grupos que desee que otros vean.Si no, los usuarios no podrán mostrar esos elementos.

Ocultar o mostrar nodos

Para mostrar u ocultar vínculos

Agregue los nodos y vínculos

Para agregar un vínculo entre los nodos existentes

1. Seleccione el nodo de origen.

   Una barra de herramientas empieza a aparecer encima del nodo.

   

2. En la barra de herramientas, elija Establezca las nuevas relaciones de este nodo al que nunca nodo que hace clic en después a continuación.Seleccione el nodo de destino.

   Un vínculo aparece entre los dos nodos.

Agregue comentarios en el gráfico

1. Seleccione el nodo donde desea agregar un comentario vinculado.

   Una barra de herramientas empieza a aparecer encima del nodo.

   

2. En la barra de herramientas, elija Cree un nuevo nodo de comentario con un nuevo vínculo al nodo seleccionado.

3. Escriba comentarios.Para escribir en una nueva línea, presione MAYÚS.+Entrar.

Elimine los nodos

Puede eliminar nodos de un gráfico sin afectar al código subyacente.Para eliminar un nodo, seleccione el nodo, y después presione la tecla eliminar.Al eliminar nodos, sus definiciones se quitan del archivo DGML (.dgml).

Al eliminar nodos de un grupo, el botón Volver a obtener elementos secundarios se produce dentro del grupo.Para recuperar nodos que falta, elija Volver a obtener elementos secundarios.Los gráficos creados editando el DGML, agregar nodos sin definir, o con versiones anteriores de Visual Studio Ultimate, no admiten esta funcionalidad.

Precaución
Antes de compartir un gráfico creado con Visual Studio Ultimate con los que usan Visual Studio Premium o Visual Studio Professional, asegúrese de que cualquier nodo que desee otros para ver está visible en el gráfico.Si no, los usuarios no podrán recuperar nodos eliminados.

Agrupe los nodos

Para agrupar nodos editando el archivo .dgml del gráfico

1. Para convertir un nodo en un grupo, abra el menú contextual para el nodo.Elija Ir a, dgml.

   Visual Studio abre el archivo .dgml del gráfico y resalta el <Node/> elemento de ese nodo.

   O bien

   Para agregar un nuevo grupo:

   1. Abrir el menú contextual del área en blanco del gráfico.Elija Ir a, dgml.

   2. En la sección <Node/>, agregue un nuevo elemento <Nodes>.

2. En el elemento <Node/>, agregue un atributo Group para especificar si el grupo aparece contraído o expandido.Por ejemplo:

   <Nodes>
      <Node Id="MyFirstGroup" Group="Expanded" />
      <Node Id="MySecondGroup" Group="Collapsed" />
   </Nodes>
   

3. En la sección <Links>, asegúrese de que existe un elemento <Link/> con los atributos siguientes para cada relación entre un nodo de grupo y sus nodos secundarios:

   • Un atributo Source que especifica el nodo de grupo

   • Un atributo Target que especifica el nodo secundario

   • Un atributo Category que especifica una relación Contains entre el nodo de grupo y su nodo secundario

   Por ejemplo:

   <Links>
      <Link Category="Contains" Source="MyFirstNewGroup" Target="FirstGroupChildOne" />
      <Link Category ="Contains" Source="MyFirstNewGroup" Target="FirstGroupChildTwo" />
      <Link Category ="Contains" Source="MySecondNewGroup" Target="SecondGroupChildOne" />
      <Link Category="Contains" Source="MySecondNewGroup" Target="SecondGroupChildTwo" />
   </Links>
   

   Para obtener más información sobre el atributo Category, vea Asignar categorías a nodos y vínculos.

Combinar gráficos

Puede combinar gráficos copiando y pegando nodos entre gráficos.Si coinciden los identificadores de nodo, los nodos de pegar funcionan como una operación de combinación.Para crear esta tarea más fácil, coloque todos los ensamblados o binarios que desea visualizar en la misma carpeta de modo que la ruta de acceso completa de cada ensamblado o binario es el mismo para cada gráfico que desee combinar.

Alternativamente, puede crear un único gráfico para los ensamblados o binarios que desea visualizar siguiendo uno de estos pasos:

• Arrastre los ensamblados o binarios al mismo gráfico.

  O bien

• explorador de arquitectura abierta.En Sistema de archivos, elija Seleccionar archivos para examinar, seleccione, y abren los ensamblados o binarios.Para refinar el gráfico, elementos específicos select que desea visualizar.Cuando termine, elija Cree un nuevo documento de gráfico de todos los nodos seleccionados en la barra de herramientas explorador de arquitectura.

Cambiar el estilo del gráfico

Puede cambiar el color de fondo y el color del borde del gráfico editando el archivo .dgml del gráfico.Para cambiar el estilo de los nodos y los vínculos, vea Cambiar el estilo de los nodos y vínculos.

1. Abrir el menú contextual de la superficie del gráfico.Elija Ir a, dgml.

   Visual Studio abre el archivo .dgml del gráfico.

2. En el elemento <DirectedGraph>, agregue cualquiera de los siguientes atributos para cambiar el estilo:

   Para cambiar el	Agregue el atributo siguiente
   Color de fondo	Background="ColorNameOrHexadecimalValue"
   Color del borde	Stroke="StrokeValue"

   Por ejemplo:

   <DirectedGraph Background="Green" xmlns="https://schemas.microsoft.com/vs/2009/dgml" >
      ...
      ...
   </DirectedGraph>
   

Cambiar el estilo de los nodos y vínculos

Puede cambiar los iconos de los nodos y los colores de los nodos y los vínculos.Puede usar colores e iconos predefinidos o especificar unos personalizados editando el archivo .dgml del gráfico.Vea Aplicar estilos personalizados a nodos y vínculos.

Por ejemplo, puede elegir un color para resaltar los nodos y los vínculos que tengan cierta categoría o propiedad.De este modo, podrá identificar áreas específicas del gráfico y concentrarse en ellas.

Para aplicar un color o icono predefinido a los nodos cierta categoría o propiedad

1. Si el cuadro Leyenda no está visible, abra el menú contextual para el gráfico.Elija Mostrar leyenda.

2. En el cuadro Leyenda, vea si la categoría o propiedad del nodo aparece en la lista.

3. Si la lista no incluye la categoría o propiedad, elija + en el cuadro Leyenda, Categoría de nodo o Propiedad de nodo, y la categoría o propiedad.

   La categoría o propiedad aparece ahora en el cuadro Leyenda.

   [!NOTA]

   Para crear y asignar una categoría a un nodo, vea Asignar categorías a nodos y vínculos.Crear y asignar una propiedad a un nodo, vea Asignar propiedades a nodos y vínculos.

4. En el cuadro Leyenda, abra la lista desplegable situada junto a la categoría o propiedad.

5. Use la tabla siguiente para seleccionar el estilo que desea cambiar:

   Para cambiar el	Choose
   Color de fondo	Background
   Color del contorno	Trazo
   Color del texto	Foreground
   Iconos	Iconos

   El cuadro Selector de conjunto de colores aparece para seleccionar un color (o icono).

6. En el cuadro de diálogo Selector de conjunto de colores, realice uno de los siguientes:

   Para aplicar a	Siga estos pasos
   Conjunto de colores (o iconos	Abra la lista Color seleccione (o icono) establecer.Seleccione un conjunto de colores (o iconos). Para volver al color (o icono) predeterminado, en la lista Color seleccione (icono) establecer, elija Ninguno.
   Color (o icono) específico	Abra la lista de categorías o de valor de propiedad.Seleccione un color (o icono).

   [!NOTA]

   Puede reorganizar, eliminar o desactivar temporalmente los estilos en el cuadro Leyenda.Vea Modificar el cuadro leyenda.

Para aplicar un color predefinido a los vínculos con una determinada categoría o propiedad

1. Si el cuadro Leyenda no está visible, abra el menú contextual para el gráfico.Elija Mostrar leyenda.

2. En el cuadro Leyenda, observe si la categoría o propiedad aparece en la lista.

3. Si la lista no incluye la categoría o propiedad, elija + en el cuadro Leyenda, Categoría de vínculo o Propiedad de vínculo, y la categoría o propiedad.

   La categoría o propiedad aparece ahora en el cuadro Leyenda.

   [!NOTA]

   Para crear y asignar una categoría a un vínculo, vea Asignar categorías a nodos y vínculos.Para crear y asignar una propiedad a un vínculo, vea Asignar propiedades a nodos y vínculos.

4. En el cuadro Leyenda, abra la lista situada al lado de la categoría o propiedad.

5. Trazo Seleccione para cambiar el esquema y la punta de flecha el color del vínculo.

   El cuadro Selector de conjunto de colores aparece para seleccionar un color.

6. En el cuadro Selector de conjunto de colores, realice uno de los siguientes:

   Para aplicar a	Siga estos pasos
   Conjunto de colores	Abra la lista Color seleccioneestablecer.Seleccione un conjunto de colores. Para volver al color predeterminado, en la lista Seleccionar conjunto de colores, elija Ninguno.
   Color específico	Abra la lista de valores de propiedad para seleccionar un color.

   [!NOTA]

   Puede reorganizar, eliminar o desactivar temporalmente los estilos en el cuadro Leyenda.Vea Modificar el cuadro leyenda.

Aplicar estilos personalizados a nodos y vínculos

Puede aplicar estilos personalizados a los siguientes elementos:

• Nodos y vínculos únicos

• Grupos de nodos y vínculos

• Grupos de nodos y vínculos de acuerdo con ciertas condiciones

Para aplicar un estilo personalizado a un único nodo

1. Abrir el menú contextual del nodo cuyo estilo desea personalizar.Elija Ir a, dgml.

   Visual Studio abre el archivo .dgml del gráfico y resalta el <Node/> elemento de ese nodo.

2. En el elemento <Node/>, agregue cualquiera de los siguientes atributos para personalizar el estilo:

   Para cambiar el	Agregue el atributo siguiente
   Color de fondo	Background="ColorNameOrHexadecimalValue"
   Contorno	Stroke="ColorNameOrHexadecimalValue"
   Grosor del contorno	StrokeThickness="StrokeValue"
   Color del texto	Foreground="ColorNameOrHexadecimalValue"
   Iconos	Icon="IconFilePathLocation"
   Tamaño del texto	FontSize="FontSizeValue"
   Tipo de texto	FontFamily="FontFamilyName"
   Grosor del texto	FontWeight="FontWeightValue"
   Estilo del texto	FontStyle="FontStyleName" Por ejemplo, puede especificar Italic como estilo de texto.
   Textura	Style="Glass" -O bien- Style="Plain"
   Forma Para reemplazar la forma con un icono, establezca la propiedad de Shape a None y establezca la propiedad de Icon a la ruta con el archivo de icono.	Shape="ShapeFilePathLocation"

   Por ejemplo:

   <Nodes>
      <Node Id="MyNode" Background="#FF008000" Stroke="#FF000000"
      Foreground="#FFFFFFFF" Icon="...\Icons\Globe.png"/>
   </Nodes>
   

Para aplicar un estilo personalizado a un único vínculo

1. En el gráfico, mueva el puntero sobre el vínculo.Una información sobre herramientas aparece e identifica el nodo de origen y el nodo de destino del vínculo.(El teclado: PresioneTab hasta el foco está en el vínculo.)

2. Abrir el menú contextual para el gráfico.Elija Ir a, dgml.

   Visual Studio abre el archivo .dgml del gráfico.

3. Busque el elemento <Link/> que contiene el nombre del nodo de origen y el nombre del nodo de destino.

4. En el elemento <Link/>, agregue cualquiera de los siguientes atributos para personalizar el estilo:

   Para cambiar el	Agregue el atributo siguiente
   Contorno y punta de flecha color	Stroke="ColorNameOrHexadecimalValue"
   Grosor del contorno	StrokeThickness="StrokeValue"
   Estilo del contorno	StrokeDashArray="StrokeArrayValues"

   Por ejemplo:

   <Links>
      <Link Source="MyFirstNode" Target="MySecondNode" Background="Green" Stroke="#FF000000" StrokeDashArray="2,2"/>
   </Links>
   

Para aplicar estilos personalizados a un grupo de nodos o vínculos

1. Asigne cualquier categoría o propiedad que desee a los nodos o vínculos.

   Sugerencia
   Si tiene estilos extensibles en varios nodos o vínculos, podría considerar aplicar una categoría a los nodos o vínculos, y después aplicar un estilo a esa categoría.Para obtener más información, vea Asignar categorías a nodos y vínculos y Asignar propiedades a nodos y vínculos.

2. Abra el menú contextual para la superficie del gráfico.Elija Ir a, dgml.

   Visual Studio abre el archivo .dgml del gráfico.

3. Si no existe ningún elemento <Styles></Styles>, agregue uno bajo el elemento <DirectedGraph></DirectedGraph>, detrás del elemento <Links></Links>.

4. En el elemento <Styles></Styles>, bajo el elemento <Style/>, especifique los atributos siguientes:

   • TargetType="Node | Link | Graph"

   • GroupLabel="NameInLegendBox"

   • ValueLabel="NameInStylePickerBox"

   Para aplicar un estilo personalizado a todos los tipos de destino, no use ninguna condición.

Para aplicar un estilo condicional a los grupos de nodos o vínculos

1. En el elemento <Style/>, agregue un elemento <Condition/> que contenga un atributo Expression para especificar una expresión que devuelva un valor booleano.

   Por ejemplo:

   <Condition Expression="MyCategory"/>
   

   -O bien-

   <Condition Expression="MyCategory > 100"/>
   

   -O bien-

   <Condition Expression="HasCategory('MyCategory')"/>
   

   Esta expresión usa la sintaxis de la forma de Backus-Naur (BNF) siguiente:

   <Expression> ::= <BinaryExpression> | <UnaryExpression> | "("<Expression>")" | <MemberBindings> | <Literal> | <Number>

   <BinaryExpression> ::= <Expression> <Operator> <Expression>

   <UnaryExpression> ::= "!" <Expression> | "+" <Expression> | "-" <Expression>

   <Operator> ::= "<" | "<=" | "=" | ">=" | ">" | "!=" | "or" | "and" | "+" | "*" | "/" | "-"

   <MemberBindings> ::= <MemberBindings> | <MemberBinding> "." <MemberBinding>

   <MemberBinding> ::= <MethodCall> | <PropertyGet>

   <MethodCall> ::= <Identifier> "(" <MethodArgs> ")"

   <PropertyGet> ::= Identifier

   <MethodArgs> ::= <Expression> | <Expression> "," <MethodArgs> | <empty>

   <Identifier> ::= [^.]*

   <Literal> ::= literal de cadena entre comillas simples o dobles

   <Number> ::= cadena de dígitos con separador decimal opcional

   Puede especificar varios elementos de <Condition/>, que deben ser true para aplicar el estilo.

2. En la línea que sigue al elemento <Condition/>, agregue uno o varios elementos <Setter/> para especificar un atributo Property y un atributo Value fijo o un atributo Expression calculado para aplicarlo al gráfico, los nodos o los vínculos que satisfacen la condición.

   Por ejemplo:

   <Setter Property="BackGround" Value="Green"/>
   

En este sencillo ejemplo completo que se muestra a continuación, la condición especifica que un nodo debe aparecer en verde o en rojo en función de si su categoría Passed está establecida en True o False:

<?xml version="1.0" encoding="utf-8"?>
<DirectedGraph xmlns="https://schemas.microsoft.com/vs/2009/dgml">
   <Nodes>
      <Node Id="MyFirstNode" Passed="True" />
      <Node Id="MySecondNode" Passed="False" />
   </Nodes>
   <Links>
   </Links>
   <Styles>
      <Style TargetType="Node" GroupLabel="Passed" ValueLabel="True">
         <Condition Expression="Passed='True'"/>
         <Setter Property="Background" Value="Green"/>
      </Style>
      <Style TargetType="Node" GroupLabel="Passed" ValueLabel="False">
         <Condition Expression="Passed='False'"/>
         <Setter Property="Background" Value="Red"/>
      </Style>
   </Styles>
</DirectedGraph>

En la tabla siguiente se incluyen algunas condiciones de ejemplo que puede usar:

<?xml version="1.0" encoding="utf-8"?>
<DirectedGraph xmlns="https://schemas.microsoft.com/vs/2009/dgml">
<Nodes>
   <Node Id="Class1" LinesOfCode ="200" />
   <Node Id="Class2" LinesOfCode ="1000" />
   <Node Id="Class3" LinesOfCode ="20" />
</Nodes>
<Properties>
   <Property Id="LinesOfCode" Label="LinesOfCode" Description="LinesOfCode" DataType="System.Int32" />
</Properties>
<Styles>
   <Style TargetType="Node" GroupLabel="LinesOfCode" ValueLabel="Function">
      <Condition Expression="LinesOfCode &gt; 0" />
      <Setter Property="FontSize" Expression="Math.Max(9,Math.Sqrt(LinesOfCode))" />
      <Setter Property="FontFamily" Value="Papyrus" />
   </Style>
</Styles>
</DirectedGraph>

<?xml version="1.0" encoding="utf-8"?>
<DirectedGraph xmlns="https://schemas.microsoft.com/vs/2009/dgml">
<Nodes>
   <Node Id="Class1" Coverage="58" />
   <Node Id="Class2" Coverage="95" />
   <Node Id="Class3" Coverage="32" />
</Nodes>
<Properties>
   <Property Id="Coverage" Label="Coverage" Description="Code coverage as a percentage of blocks" DataType="Double" />
</Properties>
<Styles>
   <Style TargetType="Node" GroupLabel="Coverage" ValueLabel="Good">
      <Condition Expression="Coverage &gt; 80" />
      <Setter Property="Background" Value="Green" />
   </Style>
   <Style TargetType="Node" GroupLabel="Coverage" ValueLabel="OK">
      <Condition Expression="Coverage &gt; 50" />
      <Setter Property="Background" Expression="Color.FromRgb(180 * Math.Max(1, (80 - Coverage) / 30), 180, 0)" />
   </Style>
   <Style TargetType="Node" GroupLabel="Coverage" ValueLabel="Bad">
      <Setter Property="Background" Expression="Color.FromRgb(180, 180 * Coverage / 50, 0)" />
   </Style>
</Styles>
</DirectedGraph>

<DirectedGraph xmlns="https://schemas.microsoft.com/vs/2009/dgml">
<Nodes>
   <Node Id="Automation" Category="Test" Label="Automation" />
   <Node Id="C# Provider" Category="Provider" Label="C# Provider" />
</Nodes>
<Categories>
   <Category Id="Provider" Icon="...\Icons\Module.png" Shape="None" />
   <Category Id="Test" Icon="...\Icons\Page.png" Shape="None" />
</Categories>
<Properties>
   <Property Id="Icon" DataType="System.String" />
   <Property Id="Label" Label="Label" Description="Displayable label of an Annotatable object" DataType="System.String" />
   <Property Id="Shape" DataType="System.String" />
</Properties>
<Styles>
   <Style TargetType="Node" GroupLabel="Group" ValueLabel="Has category">
      <Condition Expression="HasCategory('Group')" />
      <Setter Property="Background" Value="#80008080" />
   </Style>
   <Style TargetType="Node">
      <Setter Property="HorizontalAlignment" Value="Center" />
   </Style>
</Styles>
</DirectedGraph>

Modificar el cuadro Leyenda

Puede reorganizar, eliminar o desactivar temporalmente los estilos en el cuadro Leyenda:

1. Abrir el menú contextual para un estilo en el cuadro Leyenda.

2. Realice una de las tareas siguientes:

   Para	Choose
   Subir el estilo	Subir
   Bajar el elemento	Bajar
   Eliminar el elemento	Eliminar
   Desactivar el elemento	Deshabilitar
   Reactivar el elemento	Habilitar

Copiar estilos de un gráfico a otro

1. Asegúrese de que el cuadro Leyenda aparece en el gráfico de origen.Si no está visible, abra el menú contextual para un área en blanco del gráfico de origen.Elija Mostrar leyenda.

2. Abrir el menú contextual para el cuadro Leyenda.Elija Leyenda de copia.

3. Pegue la leyenda en el gráfico de destino.

Asignar propiedades a nodos y vínculos

Puede organizar los nodos y vínculos asignándoles propiedades.Por ejemplo, puede seleccionar nodos que tengan propiedades concretas para que pueda agruparlos, cambiar su estilo u ocultarlos.

Para asignar una propiedad a un nodo

1. Abra el menú contextual para el nodo.Elija Ir a, dgml.

   Visual Studio abre el archivo .dgml del gráfico y resalta el <Node/> elemento de ese nodo.

2. En el elemento <Node/>, especifique el nombre de la propiedad y su valor.Por ejemplo:

   <Nodes>
      <Node Id="MyNode" MyPropertyName="PropertyValue" />
   </Nodes>
   

3. Agregue un elemento <Property/> a la sección <Properties> para especificar atributos, como el nombre visible y el tipo de datos:

   <Properties>
      <Property Id="MyPropertyName" Label="My Property" DataType="System.DataType"/>
   </Properties>
   

Para asignar una propiedad a un vínculo

1. En el gráfico, mueva el puntero sobre el vínculo.Una información sobre herramientas aparece e identifica el nodo de origen y el nodo de destino del vínculo.(El teclado: Presione Tab hasta que el foco esté en el vínculo.)

2. Abrir el menú contextual para el gráfico.Elija Ir a, dgml.

   Visual Studio abre el archivo .dgml del gráfico.

3. Busque el elemento <Link/> que contiene el nombre del nodo de origen y el nombre del nodo de destino.

4. En el elemento <Node/>, especifique el nombre de la propiedad y su valor.Por ejemplo:

   <Links>
      <Link Source="MyFirstNode" Target="MySecondNode" MyPropertyName="PropertyValue" />
   </Links>
   

5. Agregue un elemento <Property/> a la sección <Properties> para especificar atributos, como el nombre visible y el tipo de datos:

   <Properties>
      <Property Id="MyPropertyName" Label="My Property Name" DataType="System.DataType"/>
   </Properties>
   

Asignar categorías a nodos y vínculos

Puede organizar los nodos asignándoles categorías.Por ejemplo, puede seleccionar nodos que pertenezcan a determinadas categorías para que pueda agruparlos, cambiar su estilo u ocultarlos.Puede resaltar los vínculos que tengan ciertas categorías.Para obtener más información, vea las secciones siguientes:

• Agrupe los nodos

• Cambiar el estilo de los nodos y vínculos

• Ocultar o mostrar nodos

Para asignar una categoría a un nodo

• Para asignar una categoría predefinida, como la Categoría 1, abra el menú contextual para el nodo.Elija Clasificar y una categoría predefinida.

-O bien-

• Para crear y asignar una categoría personalizada:

  • Elija el nodo que desea clasificar.Presione F4 a abrir la ventana propiedades.Escriba el nombre de categoría en la propiedad Nueva categoría de nodo.Presione ENTRAR.

  -O bien-

  1. Abra el menú contextual para el nodo.Elija Ir a, dgml.

     Visual Studio abre el archivo .dgml del gráfico y resalta el <Node/> elemento de ese nodo.

  2. En el elemento <Node/>, agregue un atributo Category para especificar el nombre de la categoría.Por ejemplo:

     <Nodes>
        <Node Id="MyNode" Category="MyCategory" />
     </Nodes>
     

  3. Agregue un elemento <Category/> a la sección <Categories> de modo que pueda usar el atributo Label con el fin de especificar el texto visualizado de esa categoría:

     <Categories>
        <Category Id="MyCategory" Label="My Category" />
     </Categories>
     

Para asignar una categoría a un vínculo

1. En el gráfico, mueva el puntero del mouse sobre el vínculo para mostrar la información sobre herramientas e identificar el nodo de origen y el nodo de destino del vínculo.(El teclado: Presione Tab hasta que el foco esté en el vínculo.)

2. Abrir el menú contextual para el gráfico.Elija Ir a, dgml.

   Visual Studio abre el archivo .dgml del gráfico.

3. Busque el elemento <Link/> que contiene el nombre del nodo de origen y el nombre del nodo de destino.

4. En el elemento <Link/>, agregue un atributo Category para especificar el nombre de la categoría.Por ejemplo:

   <Links>
      <Link Source="MyFirstNode" Target="MySecondNode" Category="MyCategory"
   </Links>
   

5. Agregue un elemento <Category/> a la sección <Categories> de modo que pueda usar el atributo Label con el fin de especificar el texto visualizado de esa categoría:

   <Categories>
      <Category Id="MyCategory" Label="My Category" />
   </Categories>
   

Puede crear categorías jerárquicas que le ayuden a organizar los nodos y a agregar atributos a categorías secundarias usando la relación de herencia.

Para crear categorías jerárquicas

• Agregue un elemento <Category/> de la categoría primaria y, a continuación, agregue el atributo BasedOn al elemento <Category/> de la categoría secundaria.

  Por ejemplo:

  <Nodes>
     <Node Id="MyFirstNode" Label="My First Node" Category= "MyCategory" />
     <Node Id="MySecondNode" Label="My Second Node" />
  </Nodes>
  <Links>
     <Link Source="MyFirstNode" Target="MySecondNode" />
  </Links>
  <Categories>
     <Category Id="MyCategory" Label="My Category" BasedOn="MyParentCategory"/>
     <Category Id="MyParentCategory" Label="My Parent Category" Background="Green"/>
  </Categories>
  

  En este ejemplo, el fondo de MyFirstNode es verde porque su atributo Category hereda el atributo Background de MyParentCategory.

Vincular elementos a nodos o vínculos

Puede vincular elementos, como documentos o direcciones URL, a un nodo o vínculo editando el archivo .dgml del gráfico y agregando un atributo de Reference al elemento de <Node/> para un nodo o elemento de <Link/> para un vínculo.Puede abrir y ver el contenido del nodo o del vínculo.El atributo Reference especifica la ruta de acceso del contenido.Puede tratarse de una ruta de acceso absoluta o de una ruta de acceso relativa a la ubicación del archivo .dgml.

Precaución
Si utiliza rutas de acceso relativas, y el archivo .dgml se mueve a otra ubicación, después las rutas resolverá ya no.Al intentar abrir y ver el contenido vinculado, un error que indica que el contenido no pueden verse aparecerá.

Por ejemplo, quizá desee vincular los elementos siguientes:

• Para describir los cambios de una clase, puede vincular la dirección URL de un elemento de trabajo, documento u otro archivo .dgml al nodo de una clase.

• Podría vincular un diagrama de capas a un nodo de grupos que representa una capa en la arquitectura lógica del software.

• Para mostrar más información sobre un componente que expone una interfaz, puede vincular un diagrama de componentes al nodo de esa interfaz.

• Vincule un nodo a un elemento de trabajo o error de Team Foundation Server, o alguna otra información relacionada con el nodo.

Para vincular un elemento a un nodo

1. En el gráfico, abra el menú contextual para el nodo.Elija Ir a, dgml.

   Visual Studio abre el archivo .dgml del gráfico y resalta el <Node/> elemento de ese nodo.

2. Realice una de las tareas de la tabla siguiente:

   Para vincular	Siga estos pasos
   Un elemento único	En el elemento de <Node/> o de <Link/>, agregue un atributo de Reference para especificar la ubicación del elemento. Nota Puede tener un atributo de Reference por el elemento. Por ejemplo: <Nodes> <Node Id="MyNode" Reference="MyDocument.txt" /> </Nodes> <Properties> <Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" /> </Properties>
   Varios elementos	En el elemento de <Node/> o de <Link/>, agregue un nuevo atributo para especificar la ubicación de cada referencia. En la sección <Properties>: Agregue un elemento <Property/> para cada nuevo tipo de referencia. Establezca al atributo Id en el nombre del nuevo atributo de referencia. Agregue el atributo de IsReference y establézcalo en True para hacer que la referencia aparece en el menú contextual ir a al elemento. Utilice el atributo de Label para especificar el texto visualizado en el menú contextual ir a al elemento. Por ejemplo: <Nodes> <Node Id="MyNode" SequenceDiagram="MySequenceDiagram.sequencediagram" ActiveBugs="MyActiveBugs.wiq"/> </Nodes> <Properties> <Property Id="SequenceDiagram" Label="My Sequence Diagram" DataType="System.String" IsReference="True" /> <Property Id="ActiveBugs" Label="Active Bugs" DataType="System.String" IsReference="True" /> </Properties>

   En el gráfico, el nombre del nodo aparece subrayado.Al abrir el menú contextual para el nodo o vínculo, verá un menú contextual ir a que contiene los elementos vinculados para elegir.

3. Use el atributo ReferenceTemplate para especificar una cadena común, como una dirección URL, que se use en varias referencias en lugar de repetir esa cadena en la referencia.

   El atributo ReferenceTemplate especifica un marcador de posición para el valor de la referencia.En el ejemplo siguiente, el marcador de posición {0} del atributo ReferenceTemplate se reemplazará por los valores de los atributos MyFirstReference y MySecondReference del elemento <Node/> para generar una ruta de acceso completa:

   <Nodes>
      <Node Id="MyNode" MyFirstReference="MyFirstDocument" MySecondReference="MySecondDocument"/>
      <Node Id="MySecondNode" MyFirstReference="AnotherFirstDocument" MySecondReference="AnotherSecondDocument"/>
   </Nodes>
   <Properties>
      <Property Id="MyFirstReference" Label="My First Document" DataType="System.String" IsReference="True" ReferenceTemplate="http://www.Fabrikam.com/FirstDocuments/{0}.asp"/>
      <Property Id="MySecondReference" Label="My Second Document" DataType="System.String" IsReference="True" ReferenceTemplate=" http://www.Fabrikam.com/SecondDocuments/{0}.asp"/>
   </Properties>
   

4. Para ver el elemento o elementos a los que se hace referencia de dibujo, abra el menú contextual para el nodo o vínculo.Elija ir a continuación el elemento.

Crear alias para rutas de acceso usadas con frecuencia

El reemplazo de rutas de acceso usadas con frecuencia con alias ayuda a reducir el tamaño del archivo .dgml y el tiempo necesario para cargar o guardar el archivo.Para crear un alias, agregue una sección <Paths></Paths> al final del archivo .dgml.En esta sección, agregue un elemento <Path/> para definir un alias para la ruta de acceso:

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

Para hacer referencia al alias desde un elemento del archivo .dgml, rodee el valor Id del elemento <Path/> con un signo de dólar ($) y paréntesis (()):

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

Introducción a Directed Graph Markup Language (DGML)

DGML usa XML simple para describir los gráficos dirigidos cíclicos y acíclicos.Un gráfico dirigido es un conjunto de nodos que están conectados mediante vínculos, o bordes.Se pueden usar nodos y vínculos para representar estructuras de red, como elementos en un proyecto de software.Use DGML para visualizar información, realizar análisis de complejidad o simplemente examinar y editar gráficos dirigidos.

Los nodos y vínculos se llaman elementos de gráfico o solo elementos.En la tabla siguiente se describen los tipos de elementos que se emplean en DML:

[!NOTA]

Al editar un archivo .dgml, IntelliSense le ayuda a identificar los atributos disponibles para cada elemento y sus valores.Para especificar color en un atributo, use nombres para los colores comunes, como "Blue", o valores hexadecimales de ARGB, como "#ffa0b1c3".DGML emplea un pequeño subconjunto de los formatos de definición de color de Windows Presentation Foundation (WPF).Para obtener más información, vea Colors Class.

Elemento	Formato de ejemplo
<DirectedGraph></DirectedGraph> Este elemento es el elemento raíz de un documento de gráfico dirigido (.dgml).Todos los demás elementos de DGML aparecen dentro del ámbito de este elemento. En la lista siguiente se describen atributos opcionales que puede incluir: Background: color del fondo del gráfico BackgroundImage: ubicación de un archivo de imagen que se va a usar como fondo del gráfico. GraphDirection: cuando el gráfico está establecido en el diseño de árbol (Sugiyama), organiza los nodos para que la mayoría de los vínculos fluyan en la dirección especificada: TopToBottom, BottomToTop, LeftToRight o RightToLeft.Vea Examinar y reorganizar gráficos de dependencias. Layout: establece el gráfico en los diseños siguientes: None, Sugiyama (diseño de árbol), ForceDirected (clústeres rápidos) o DependencyMatrix.Vea Examinar y reorganizar gráficos de dependencias. NeighborhoodDistance: cuando el gráfico está establecido en el diseño de árbol o de clústeres rápidos, solo muestra aquellos nodos que están a un número especificado (1-7) de vínculos de los nodos seleccionados.Vea Examinar y reorganizar gráficos de dependencias. Title: nombre del gráfico. ZoomLevel: nivel de zoom usado para mostrar el gráfico inicialmente.Especifique un valor de punto flotante donde 1 es 100% o Fit para ajustar el gráfico al tamaño de la ventana.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" Background="Blue" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Nodes> ... </Nodes> <Links> ... </Links> <Categories> ... </Categories> <Properties> ... </Properties> </DirectedGraph>
<Nodes></Nodes> Este elemento opcional contiene una lista de elementos <Node/>, que definen nodos del gráfico.Para obtener más información, vea el elemento <Node/>. Nota Al hacer referencia a un nodo no definido en un elemento <Link/>, el gráfico crea un elemento <Node/> automáticamente.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Nodes> <Node ... /> </Nodes> <Links> <Link ... /> </Links> </DirectedGraph>
<Node/> Este elemento define un único nodo.Aparece dentro de la lista de elementos <Nodes><Nodes/>. Este elemento debe incluir los atributos siguientes: Id: nombre único del nodo y el valor predeterminado del atributo Label, si no se especifica ningún atributo Label independiente.Este nombre debe coincidir con el atributo Source o Target del vínculo que hace referencia a él. En la lista siguiente se describen algunos atributos opcionales que puede incluir: Label: nombre para mostrar del nodo. Atributos de estilo.Vea Aplicar estilos personalizados a nodos y vínculos. Category: nombre de una categoría que identifica elementos que comparten este atributo.Para obtener más información, vea el elemento <Category/>. Property: nombre de una propiedad que identifica elementos que tienen el mismo valor de propiedad.Para obtener más información, vea el elemento <Property/>. Group: si el nodo contiene otros nodos, establezca este atributo en Expanded o Collapsed para mostrar u ocultar su contenido.Debe haber un elemento <Link/> que incluya el atributo Category="Contains" y especifique el nodo primario como nodo de origen y el nodo secundario como nodo de destino.Vea Organizar nodos en grupos. Visibility: establezca este atributo en Visible, Hidden o Collapsed.Utilice System.Windows.Visibility.Vea Ocultar o mostrar Nodos. Reference: establezca este atributo para vincular un documento o una dirección URL.Vea Vincular elementos a Nodos.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Nodes> <Node Id="Driver" Label="Student" Category="Person" /> <Node Id="Passenger" Label="Instructor" Category="Person" /> <Node Id="Car" Label="Car" Category="Automobile" /> <Node Id="Truck" Label="Truck" Category="Automobile" /> </Nodes> <Links> <Link ... /> </Links> <Categories> <Category Id="Person" Background="Orange" /> <Category Id="Automobile" Background="Yellow"/> </Categories> </DirectedGraph>
<Links></Links> Este elemento contiene la lista de elementos <Link>, que definen vínculos entre nodos.Para obtener más información, vea el elemento <Link/>.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Links> <Link ... /> </Links> </DirectedGraph>
<Link/> Este elemento define un único vínculo que conecta un nodo de origen con un nodo de destino.Aparece dentro de la lista de elementos <Links></Links>. Nota Si este elemento hace referencia a un nodo no definido, el documento de gráfico crea automáticamente un nodo que tiene los atributos especificados, si existe. Este elemento debe incluir los atributos siguientes: Source: nodo de origen del vínculo. Target: nodo de destino del vínculo. En la lista siguiente se describen algunos atributos opcionales que puede incluir: Label: nombre para mostrar del vínculo. Atributos de estilo.Vea Aplicar estilos personalizados a nodos y vínculos. Category: nombre de una categoría que identifica elementos que comparten este atributo.Para obtener más información, vea el elemento <Category/>. Property: nombre de una propiedad que identifica elementos que tienen el mismo valor de propiedad.Para obtener más información, vea el elemento <Property/>.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Nodes> <Node Id="Driver" Label="Student" Category="Person" /> <Node Id="Passenger" Label="Instructor" Category="Person" /> <Node Id="Car" Label="Car" Category="Automobile" /> <Node Id="Truck" Label="Truck" Category="Automobile" /> </Nodes> <Links> <Category Id="Person" Background="Orange" /> <Category Id="Automobile" Background="Yellow"/> <Link Source="Driver" Target="Car" Label="Passed" Stroke="Black" Background="Green" Category="PassedTest" /> <Link Source="Driver" Target="Truck" Label="Failed" Stroke="Black" Background="Red" Category="PassedTest" /> </Links> </DirectedGraph>
<Categories></Categories> Este elemento contiene la lista de elementos <Category/>.Para obtener más información, vea el elemento <Category/>.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Categories> <Category ... /> </Categories> </DirectedGraph>
<Category/> Este elemento define un atributo Category, que se emplea para identificar elementos que comparten este atributo.Se puede usar un atributo Category para organizar elementos de gráfico, proporcionar atributos compartidos a través de la herencia o definir metadatos adicionales. Este elemento debe incluir los atributos siguientes: Id: nombre único de la categoría y el valor predeterminado del atributo Label, si no se especifica ningún atributo Label independiente. En la lista siguiente se describen algunos atributos opcionales que puede incluir: Label: nombre de fácil lectura para la categoría. BasedOn: categoría principal de la que se hereda el atributo <Category/> del elemento actual. En el ejemplo de este elemento, la categoría FailedTest hereda su atributo Stroke de la categoría PassedTest.Vea “para crear categorías jerárquicas” en Asignar categorías a nodos y vínculos. Las categorías también proporcionan cierto comportamiento de plantilla básico que controla la apariencia de los nodos y vínculos cuando se muestran en un gráfico.Vea Aplicar estilos personalizados a nodos y vínculos.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Nodes> <Node Id="Driver" Label="Driver" Category="Person" /> <Node Id="Car" Label="Car" Category="Automobile" /> <Node Id="Truck" Label="Truck" Category="Automobile" /> <Node Id="Passenger" Category="Person" /> </Nodes> <Links> <Link Source="Driver" Target="Car" Label="Passed" Category="PassedTest" /> <Link Source="Driver" Target="Truck" Label="Failed" Category="FailedTest" /> </Links> <Categories> <Category Id="Person" Background="Orange" /> <Category Id="Automobile" Background="Yellow"/> <Category Id="PassedTest" Label="Passed" Stroke="Black" Background="Green" /> <Category Id="FailedTest" Label="Failed" BasedOn="PassedTest" Background="Red" /> </Categories> </DirectedGraph>
<Properties></Properties> Este elemento contiene la lista de elementos <Property/>.Para obtener más información, vea el elemento <Property/>.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Properties> <Property ... /> </Properties> </DirectedGraph>
<Property/> Este elemento define un atributo Property que puede usar para asignar un valor a cualquier elemento de DGML o atributo, incluyendo categorías y otras propiedades. Este elemento debe incluir los atributos siguientes: Id: nombre único de la propiedad y el valor predeterminado del atributo Label, si no se especifica ningún atributo Label independiente. DataType: tipo de datos almacenados por la propiedad. Si desea que la propiedad aparezca en la ventana Propiedades, use la propiedad Label para especificar el nombre para mostrar de la propiedad. Vea Asignar propiedades a nodos y vínculos.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Nodes> <Node Id="Driver" Label="Driver" Category="Person" DrivingAge="18"/> <Node Id="Car" Label="Car" Category="Automobile" /> <Node Id="Truck" Label="Truck" Category="Automobile" /> <Node Id="Passenger" Category="Person" /> </Nodes> <Links> <Link Source="Driver" Target="Car" Label="Passed" Category="PassedTest" /> <Link Source="Driver" Target="Truck" Label="Failed" Category="FailedTest" /> </Links> <Categories> <Category Id="Person" Background="Orange" /> <Category Id="Automobile" Background="Yellow"/> <Category Id="PassedTest" Label="Passed" Stroke="Black" Background="Green" /> <Category Id="FailedTest" Label="Failed" BasedOn="PassedTest" Background="Red" /> </Categories> <Properties> <Property Id="DrivingAge" Label="Driving Age" DataType="System.Int32" /> </Properties> </DirectedGraph>

Vea también

Conceptos

Visualizar dependencias de código en gráficos de dependencias

Examinar y reorganizar gráficos de dependencias