Editar e personalizar gráficos de dependência

Você pode editar elementos gráficos de dependência sem afetar o código subjacente.Isso é útil quando você deseja se concentra em itens principais ou para comunicar exibições sobre o código.Por exemplo, para realçar áreas interessantes, você pode selecionar nós e filtrar-los, altere o estilo de nós e links, o couro cru ou os nós delete, e organizar nós usando propriedades, categorias, ou grupos.

Você pode personalizar um gráfico mesmo adicional editando o arquivo direcionado de linguagem de marcação de gráfico de gráfico (.dgml).Por exemplo, você pode editar elementos para especificar estilos personalizados, para atribuir propriedades e categorias nós e links, ou nós de link para itens, como documentos, URL, ou outros elementos gráficos.

Observação

O Visual Studio limpa todos os elementos não usadas e atributos de DGML excluindo os quando você salvar o arquivo de .dgml.Também cria elementos de nós automaticamente quando você adicionar manualmente os novos links. Quando você salvar o arquivo de .dgml, todos os atributos que você adicionasse a um elemento podem reorganizar-se em ordem alfabética.Para obter mais informações sobre os elementos de DGML, consulte Linguagem de marcação direcionada compreensão (DGML) chart.

Requisitos

• Visual Studio Ultimate, Visual Studio Premium ou Visual Studio Professional

  Para criar gráficos de dependência, você deve ter o Visual Studio final.Consulte Visualizar dependências de código em gráficos de dependência.

Neste tópico

• Selecione nós ou links

• Renomear nós ou links

• Ocultar ou exibir nós e links

• Adicionar nós e links

• Adicionar comentários para o gráfico

• Excluir nós

• Nós agrupar

• Mesclar gráficos

• Alterar o estilo de gráfico

• Alterar o nó ou vincular o estilo

• Copiar estilos de um gráfico para outro gráfico

• Atribuir propriedades nós e a links

• Atribuir categorias a nós e a links

• Vincule itens nós ou para links

• Criar alias para caminhos de uso geral

Selecione nós ou links

Renomear nós ou links

• Selecione o nó ou o link.Pressione F2.Quando a caixa de edição aparece, renomeie o nó ou do link.

  Se o rótulo é visível, selecione o rótulo.

Ocultar ou exibir nós e links

Ocultando nós manter-los de participação em algoritmos de layout.Por padrão, os links entre grupo são ocultos.Links entre grupo são links individuais conectando nós através de grupos.Quando os grupos são recolhidos, o gráfico agrega todos os links do grupo cruzado nos únicos links entre grupos.Quando você expandir um grupo e um nós selecionados dentro do grupo, os links do grupo cruzado aparecem e mostram as dependências no grupo.

Cuidado
Antes de compartilhar um gráfico criado no Visual Studio Ultimate com aqueles que usam o Visual Studio Premium ou o Visual Studio Professional, certifique-se de re-exibir quaisquer nós ou links entre grupos que deseja serem visualizados por outras pessoas.Se não, os usuários poderão reexibir esses itens.

Para ocultar ou exibir nós

Para mostrar ou ocultar os links

Adicionar nós e links

Para adicionar um link entre nós existentes

1. Selecione o nó de origem.

   Iniciar uma barra de ferramentas para aparecer acima do nó.

   

2. Na barra de ferramentas, escolha Criar novo link deste nó para qualquer nó que você clicar em seguida.Selecione o nó de destino.

   Um link aparece entre os dois nós.

Adicionar comentários para o gráfico

1. Selecione o nó onde você deseja adicionar um comentário associado.

   Iniciar uma barra de ferramentas para aparecer acima do nó.

   

2. Na barra de ferramentas, escolha Crie um novo nó de comentário com um novo link para o nó selecionado.

3. Digite seus comentários.Para digitar em uma nova linha, pressione SHIFT+Enter.

Excluir nós

Você pode excluir nós de um gráfico sem afetar o código subjacente.Para excluir um nó, selecione o nó, e pressione a tecla de Excluir .Quando você exclui nós, suas definições são removidas de arquivo de DGML (.dgml).

Quando você exclui nós de um grupo, o botão de Filhos de Refetch aparece no grupo.Para recuperar nós ausente, escolha Nova Busca de Filhos.Os gráficos que são criados editando o DGML, adicionando nós indefinidas, ou usando as versões anteriores do Visual Studio finais, não suportam este recurso.

Cuidado
Antes de compartilhar um gráfico que foi criado usando o Visual Studio Ultimate com aqueles que usam o Visual Studio Premium ou o Visual Studio Professional, certifique-se de que quaisquer nós que você deseja que outros vejam estejam visíveis no gráfico.Se não, os usuários poderão recuperar nós excluídos.

Nós agrupar

Para agrupar nós editando o arquivo gráfico de .dgml

1. Para converter um nó para um grupo, abra o menu de atalho para o nó.Escolha Ir para, DGML.

   O Visual Studio abre o arquivo de .dgml de gráfico e ressalta o elemento de <Node/> para este nó.

   -  ou  -

   Para adicionar um novo grupo:

   1. Abra o menu de atalho para uma área em branco de gráfico.Escolha Ir para, DGML.

   2. Na seção de <Nodes> , adicione um novo elemento de <Node/> .

2. No elemento de <Node/> , adicione um atributo de Group para especificar se o grupo é expandido ou recolhido.Por exemplo:

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

3. Na seção de <Links> , certifique-se de que um elemento de <Link/> que tem os seguintes atributos existir para cada relacionamento entre um nó de grupo e seus nós filho:

   • Um atributo de Source que especifica o nó do grupo

   • Um atributo de Target que especifica o nó filho

   • Um atributo de Category que especifica uma relação de Contains entre o nó de grupo e o nó filho

   Por exemplo:

   <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 obter mais informações sobre o atributo de Category , consulte Atribuir categorias a nós e a links.

Mesclar gráficos

Você pode mesclar gráficos copiar e colar nós entre elementos gráficos.Se os identificadores de nó coincidirem, então cole nós funciona como uma operação de mesclagem.Para facilitar essa tarefa, coloque todos os assemblies ou binários que você deseja visualizar na mesma pasta de modo que o caminho completo de cada assembly ou binária é o mesmo para cada elemento gráfico que você deseja mesclar.

Como alternativa, você pode criar um único elemento gráfico para assemblies ou os binários que você deseja visualizar seguindo um dessas etapas:

• Arraste conjuntos os binários ou ao mesmo gráfico.

  -  ou  -

• Arquitetura Exploreraberto.Em Sistema de arquivos, escolha Selecionar Arquivos para procurar, selecione, e abrir assemblies ou os binários.Para refinar o gráfico, selecione os itens específicos que você deseja visualizar.Quando você terminar, escolha Crie um novo documento de gráfico de todos os nós selecionados na barra de ferramentas Arquitetura Explorer .

Alterar o estilo de gráfico

Você pode alterar a cor do plano de fundo e limitar a cor do gráfico editando o arquivo de .dgml de gráfico.Para alterar o estilo de nós e os links, consulte Alterar o estilo de nós e os links.

1. Abra o menu de atalho da superfície do gráfico.Escolha Ir para, DGML.

   O Visual Studio abre o arquivo de .dgml de gráfico.

2. No elemento de <DirectedGraph> , adicione alguns dos seguintes atributos para alterar o estilo:

   Para alterar	Adicione o seguinte atributo
   Cor do plano de fundo	Background="ColorNameOrHexadecimalValue"
   Cor da borda	Stroke="StrokeValue"

   Por exemplo:

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

Alterar o estilo de nós e os links

Você pode alterar os ícones de nós e as cores de nós e os links.Você pode usar cores e ícones predefinidos, ou você pode especificar utilizar um editando o arquivo de .dgml de gráfico.Consulte Aplicar estilos personalizados para nós e a links.

Por exemplo, você pode escolher uma cor para realçar os nós e links que têm uma determinada categoria ou propriedade.Isso permite que você identificar e focalizar áreas específicas do gráfico.

Para aplicar uma cor ou um ícone predefinido nós com uma determinada categoria ou propriedade

1. Se a caixa de Legenda não estiver visível, abra o menu de atalho para o gráfico.Escolha Mostrar Legenda.

2. Na caixa de Legenda , verifique se a categoria ou propriedade do nó aparecem na lista.

3. Se a lista não inclui a categoria ou a propriedade, escolha + na caixa de Legenda , Categoria do nó ou Propriedade do nó, e a categoria ou propriedade.

   A categoria ou a propriedade agora aparecem na caixa de Legenda .

   Observação
   Para criar e atribuir uma categoria a um nó, consulte Atribuir categorias a nós e a links.Para criar e atribuir uma propriedade em um nó, consulte Atribuir propriedades nós e a links.

4. Na caixa de Legenda , abra a lista suspensa próxima de categoria ou propriedade.

5. Use a tabela a seguir para selecionar o estilo que você deseja modificar:

   Para alterar	Choose
   Cor do plano de fundo	Plano de fundo
   Outline a cor	Traço
   Cor do texto	Primeiro plano
   Ícone	Ícones

   A caixa do O selecionador de cores ajustada parece que você selecione uma cor (ou o ícone).

6. Na caixa de diálogo O selecionador de cores ajustada , execute um destes procedimentos:

   Para aplicar a	Executar estas etapas
   Conjunto de cores (ou de ícones	Abra a lista de Selecionar Cor (ou ícone) conjunto .Selecione um conjunto de cores (ou de ícones). Para reverter para a cor padrão (ou o ícone), na lista de conjunto Selecionar Cor (ícone), escolha Nenhum.
   Cor específica (ou ícone)	Abra a lista de categorias ou de valor de propriedade.Selecione uma cor (ou o ícone).

   Observação
   Você pode reorganizar, excluir, ou desativar temporariamente estilos na caixa de Legenda .Consulte Modifique a caixa de legenda.

Para aplicar uma cor predefinido para links com uma determinada categoria ou propriedade

1. Se a caixa de Legenda não estiver visível, abra o menu de atalho para o gráfico.Escolha Mostrar Legenda.

2. Na caixa de Legenda , verifique se a categoria ou a propriedade aparecem na lista.

3. Se a lista não inclui a categoria ou a propriedade, escolha + na caixa de Legenda , Categoria de link ou Propriedade de link, e a categoria ou propriedade.

   A categoria ou a propriedade agora aparecem na caixa de Legenda .

   Observação
   Para criar e atribuir uma categoria a um link, consulte Atribuir categorias a nós e a links.Para criar e atribuir uma propriedade para um link, consulte Atribuir propriedades nós e a links.

4. Na caixa de Legenda , abra a caixa de listagem ao lado da categoria ou propriedade.

5. Selecione Traço para alterar o contorno de link e cor de seta.

   A caixa do O selecionador de cores ajustada parece que você selecione uma cor.

6. Na caixa do O selecionador de cores ajustada , execute um destes procedimentos:

   Para aplicar a	Executar estas etapas
   Conjunto de cores	Abra a lista de Selecionar Corconjunto .Selecione um conjunto de cores. Para reverter para a cor padrão, na lista de Selecionar conjunto de cores , escolha Nenhum.
   Cor específica	Abra a lista de tipo ou de valor de propriedade para selecionar uma cor.

   Observação
   Você pode reorganizar, excluir, ou desativar temporariamente estilos na caixa de Legenda .Consulte Modifique a caixa de legenda.

Aplicar estilos personalizados para nós e a links

Você pode aplicar personalizados para os seguintes itens:

• Nós únicos e links

• Grupos de nós e links

• Grupos de nós e links com base em determinadas condições

Para aplicar um estilo personalizado a um único nó

1. Abra o menu de atalho para o nó cujo estilo você deseja personalizar.Escolha Ir para, DGML.

   O Visual Studio abre o arquivo de .dgml de gráfico e ressalta o elemento de <Node/> para este nó.

2. No elemento de <Node/> , adicione alguns dos seguintes atributos para personalizar o seu estilo:

   Para alterar	Adicione o seguinte atributo
   Cor do plano de fundo	Background="ColorNameOrHexadecimalValue"
   Estrutura	Stroke="ColorNameOrHexadecimalValue"
   Espessura de estrutura	StrokeThickness="StrokeValue"
   Cor do texto	Foreground="ColorNameOrHexadecimalValue"
   Ícone	Icon="IconFilePathLocation"
   Tamanho do texto	FontSize="FontSizeValue"
   Tipo de texto	FontFamily="FontFamilyName"
   Peso de texto	FontWeight="FontWeightValue"
   Estilo de texto	FontStyle="FontStyleName" Por exemplo, você pode especificar Italic como o estilo de texto.
   Textura	Style="Glass" - ou - Style="Plain"
   Forma Para substituir a forma com um ícone, defina a propriedade de Shape a None e defina a propriedade de Icon o caminho com o arquivo de ícone.	Shape="ShapeFilePathLocation"

   Por exemplo:

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

Para aplicar um estilo personalizado a um único link

1. O elemento gráfico, mova o ponteiro do mouse sobre o link.Uma ferramenta de dica aparece e identifica o nó de origem e o nó de destino do link.(Teclado: PressioneTab até o foco estiver no link.)

2. Abra o menu de atalho para o gráfico.Escolha Ir para, DGML.

   O Visual Studio abre o arquivo de .dgml de gráfico.

3. Localize o elemento de <Link/> que contém os dois nomes de nó de origem e o nó de destino.

4. No elemento de <Link/> , adicione alguns dos seguintes atributos para personalizar o seu estilo:

   Para alterar	Adicione o seguinte atributo
   Estrutura e cor da seta	Stroke="ColorNameOrHexadecimalValue"
   Espessura de estrutura	StrokeThickness="StrokeValue"
   Estilo de estrutura	StrokeDashArray="StrokeArrayValues"

   Por exemplo:

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

Para aplicar estilos personalizados a um grupo de nós ou de links

1. Atribuir todas as categorias ou propriedades que você desejar nós ou para links.

   Dica
   Se você tiver repita estilos entre vários nós ou links, você pode considerar aplicar uma categoria 2 os nós ou links, e então aplicar um estilo a essa categoria.Para obter mais informações, consulte Atribuir categorias a nós e a links e Atribuir propriedades nós e a links.

2. Abra o menu de atalho para a superfície de gráfico.Escolha Ir para, DGML.

   O Visual Studio abre o arquivo de .dgml de gráfico.

3. Se um elemento de <Styles></Styles> não existir, adicione um sob o elemento de <DirectedGraph></DirectedGraph> após o elemento de <Links></Links> .

4. No elemento de <Styles></Styles> , no elemento de <Style/> e especificar os seguintes atributos:

   • TargetType="Node | Link | Graph"

   • GroupLabel="NameInLegendBox"

   • ValueLabel="NameInStylePickerBox"

   Para aplicar um estilo personalizado para todos os tipos de destino, não use uma condição.

Para aplicar um estilo condicional grupos de nós ou de links

1. No elemento de <Style/> , adicione um elemento de <Condition/> que contém um atributo de Expression para especificar uma expressão que retorna um valor Booleano.

   Por exemplo:

   <Condition Expression="MyCategory"/>
   

   - ou -

   <Condition Expression="MyCategory > 100"/>
   

   - ou -

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

   Esta expressão usa a seguinte sintaxe de (BNF) de forma de formato Backus-Naur:

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

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

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

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

   ::= <MemberBindings> de<MemberBindings> | <MemberBinding> “.” <MemberBinding>

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

   ::= <Identifier> de<MethodCall> “(” ")” <MethodArgs>

   identificador de ::= de<PropertyGet>

   ::= <Expression> de<MethodArgs> | <Expression> “,” <MethodArgs> | <empty>

   ::= de<Identifier> [^.]*

   literal de citado de ::= de<Literal> único ou de cadeia de caracteres

   cadeia de caracteres de ::= de<Number> de dígitos com ponto decimal opcional

   Você pode especificar vários elementos de <Condition/>, que elas devem todas ser verdadeiros aplicar o estilo.

2. Na próxima linha após o elemento de <Condition/> , adicionar um ou vários elementos de <Setter/> para especificar um atributo de Property e um atributo fixo de Value ou um atributo computado de Expression para aplicar o gráfico, nós, ou para links que atendem a condição.

   Por exemplo:

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

Como um exemplo completo simples, a condição a seguir especifica que um nó aparece verde ou vermelho com base em se sua categoria de Passed é definida como True ou a 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>

A tabela a seguir inclui um exemplo condiciona que você pode 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>

Modifique a caixa de legenda

Você pode reorganizar, excluir, ou desativar temporariamente estilos na caixa de Legenda :

1. Abra o menu de atalho para um estilo na caixa de Legenda .

2. Execute uma das seguintes tarefas:

   Para	Choose
   Mova o estilo	Mova
   Mova o item	Mova
   Excluir o item	Excluir
   Desativar o item	Desativar
   Reativar o item	Ativar

Copiar estilos de um gráfico para outro gráfico

1. Certifique-se de que a caixa de Legenda aparece no gráfico de origem.Se não estiver visível, abra o menu de atalho para uma área em branco de gráfico de origem.Escolha Mostrar Legenda.

2. Abra o menu de atalho para a caixa de Legenda .Escolha Copie a legenda.

3. Cole a legenda o elemento gráfico de destino.

Atribuir propriedades nós e a links

Você pode organizar nós e links para atribuir propriedades a eles.Por exemplo, você pode selecionar os nós que têm propriedades específicas de modo que você possa as agrupar, altere seu estilo, ou ocultar as.

Para atribuir uma propriedade para um nó

1. Abra o menu de atalho para o nó.Escolha Ir para, DGML.

   O Visual Studio abre o arquivo de .dgml de gráfico e ressalta o elemento de <Node/> para este nó.

2. No elemento de <Node/> , especifique o nome da propriedade e seu valor.Por exemplo:

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

3. Adicione um elemento de <Property/> à seção de <Properties> para especificar atributos como seu nome e tipo de dados visíveis:

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

Para atribuir uma propriedade para um link

1. O elemento gráfico, mova o ponteiro do mouse sobre o link.Uma ferramenta de dica aparece e identifica o nó de origem e o nó de destino do link.(Teclado: Pressione Tabulação até o foco estiver no link.)

2. Abra o menu de atalho para o gráfico.Escolha Ir para, DGML.

   O Visual Studio abre o arquivo de .dgml de gráfico.

3. Localize o elemento de <Link/> que contém os dois nomes de nó de origem e o nó de destino.

4. No elemento de <Node/> , especifique o nome da propriedade e seu valor.Por exemplo:

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

5. Adicione um elemento de <Property/> à seção de <Properties> para especificar atributos como seu nome e tipo de dados visíveis:

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

Atribuir categorias a nós e a links

Você pode organizar nós atribuir categorias a eles.Por exemplo, você pode selecionar os nós que estão em determinadas categorias de modo que você possa as agrupar, altere seu estilo, ou ocultar as.Você pode realçar os links que possuem certas categorias.Para obter mais informações, consulte as seções a seguir:

• Nós agrupar

• Alterar o estilo de nós e os links

• Ocultar ou exibir nós

Para atribuir uma categoria a um nó

• Para atribuir uma categoria predefinida, como Categoria 1, abra o menu de atalho para o nó.Escolha Categorizar e uma categoria pré-definida.

- ou -

• Para criar e atribuir uma categoria personalizado:

  • Escolha o nó que você deseja classificar.Pressione F4 para abrir a janela de Propriedades .Digite o nome da categoria na propriedade de Nova Categoria de nó.Pressione ENTER.

  - ou -

  1. Abra o menu de atalho para o nó.Escolha Ir para, DGML.

     O Visual Studio abre o arquivo de .dgml de gráfico e ressalta o elemento de <Node/> para este nó.

  2. No elemento de <Node/> , adicione um atributo de Category para especificar o nome da categoria.Por exemplo:

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

  3. Adicione um elemento de <Category/> à seção de <Categories> para que você possa usar o atributo de Label para especificar o texto exibido para essa categoria:

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

Para atribuir uma categoria a um link

1. O elemento gráfico, mova o ponteiro do mouse sobre o link para mostrar o tooltip e para identificar o nó de origem e o nó de destino do link.(Teclado: Pressione Tabulação até o foco estiver no link.)

2. Abra o menu de atalho para o gráfico.Escolha Ir para, DGML.

   O Visual Studio abre o arquivo de .dgml de gráfico.

3. Localize o elemento de <Link/> que contém os dois nomes de nó de origem e o nó de destino.

4. No elemento de <Link/> , adicione um atributo de Category para especificar o nome da categoria.Por exemplo:

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

5. Adicione um elemento de <Category/> à seção de <Categories> para que você possa usar o atributo de Label para especificar o texto exibido para essa categoria:

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

Você pode criar categorias hierárquicos para ajudar você a organizar e nós adicionar atributos as categorias filho usando a herança.

Para criar categorias hierárquicos

• Adicione um elemento de <Category/> para a categoria pai e em seguida, adicione o atributo de BasedOn para o elemento de <Category/> de categoria filho.

  Por exemplo:

  <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>
  

  Nesse exemplo, o plano de fundo de MyFirstNode é verde porque o atributo de Category herda o atributo de Background de MyParentCategory.

Vincule itens nós ou para links

Você pode vincular itens, como documentos URL, ou a um nó ou um link editando o arquivo de .dgml de gráfico e adicionando um atributo Reference para o elemento de <Node/> para um nó ou elemento de <Link/> para um link.Você pode abrir e exibir o conteúdo do nó ou link.O atributo de Reference especifica o caminho do conteúdo.Isso pode ser um caminho relativo para o local do arquivo de .dgml ou um caminho absoluto.

Cuidado
Se você usar caminhos relativos, e o arquivo de .dgml é movido para um local diferente, então os caminhos não vai determinar.Quando você tenta abrir e exibir o conteúdo associado, um erro que indica que o conteúdo não pode ser exibido ocorrerá.

Por exemplo, convém vincular os seguintes itens:

• Para descrever as alterações a uma classe, você pode vincular o URL de um item de trabalho, do documento, ou outro arquivo de .dgml o nó para uma classe.

• Você pode vincular um diagrama de camada a um nó de grupo que representa uma camada lógica na arquitetura de software.

• Para mostrar mais informações sobre um componente que expõe uma interface, você pode vincular um diagrama componente ao nó para a interface.

• Um nó vincular a um item ou um erro de trabalho Team Foundation Server, ou qualquer outra informação que estão relacionadas ao nó.

Para vincular um item para um nó

1. O elemento gráfico, abra o menu de atalho para o nó.Escolha Ir para, DGML.

   O Visual Studio abre o arquivo de .dgml de gráfico e ressalta o elemento de <Node/> para este nó.

2. Execute uma das tarefas na tabela a seguir:

   Para vincular	Executar estas etapas
   Um único item	No elemento de <Node/> ou de <Link/> , adicione um atributo de Reference para especificar o local do item. Observação Você pode ter apenas um atributo de Reference pelo elemento. Por exemplo: <Nodes> <Node Id="MyNode" Reference="MyDocument.txt" /> </Nodes> <Properties> <Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" /> </Properties>
   Vários itens	No elemento de <Node/> ou de <Link/> , adicione um novo atributo para especificar o local de cada referência. Na seção de <Properties> : Adicione um elemento de <Property/> para cada novo tipo de referência. Defina o atributo de Id o nome do novo atributo de referência. Adicione o atributo de IsReference e defina-o como True para fazer a referência aparecer no menu de atalho de Ir para o item. Use o atributo de Label para especificar o texto exibido no menu de atalho de Ir para o item. Por exemplo: <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>

   O elemento gráfico, o nome do nó aparece sublinhado.Quando você abre o menu de atalho para o nó ou o link, você verá um menu de atalho de Ir para que contém os itens associados para que você escolha.

3. Use o atributo de ReferenceTemplate para especificar uma cadeia de caracteres comuns, como um URL, que é usado por vários referências em vez de repetição essa cadeia de caracteres na referência.

   O atributo de ReferenceTemplate especificar um espaço reservado para o valor de referência.No exemplo a seguir, o espaço reservado de {0} no atributo de ReferenceTemplate será substituído pelos valores de atributos MyFirstReference e de MySecondReference no elemento de <Node/> para gerar um caminho completo:

   <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 exibir o item ou itens referenciados de gráfico, abra o menu de atalho para o nó ou do link.Escolha Ir para e o item.

Criar alias para caminhos de uso geral

Substituindo caminhos de usados com alias ajuda a reduzir o tamanho do arquivo de .dgml e de tempo necessário para carregar ou salve o arquivo.Para criar um alias, adicione uma seção de <Paths></Paths> no final do arquivo de .dgml.Nesta seção, adicione um elemento de <Path/> para definir um alias para o caminho:

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

Para referenciar alias de um elemento no arquivo de .dgml, incluindo o valor de Id do elemento de <Path/> com um cifrão ($) e parênteses (()):

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

Linguagem de marcação direcionada compreensão (DGML) chart

DGML usa XML simples para descrever gráficos direcionados cíclicos e acíclicos.Um gráfico direcionado é um conjunto de nós que estão conectados por links, ou de bordas.Os nós e links podem ser usados representam estruturas de rede, como elementos em um projeto de software.Use DGML para visualizar informações, para executar a análise de complexidade, ou procurar e editar apenas direcionaram gráficos.

Os nós e links são chamados elementos de gráfico, ou apenas os elementos.A tabela a seguir descreve os tipos de elementos que são usados em DGML:

Observação

Quando você edita um arquivo de .dgml, ajuda do IntelliSense você identifica os atributos que estão disponíveis para cada elemento e seus valores.Para especificar a cor em um atributo, use cores para nomes comuns, como “blue”, ou valores hexadecimais ARGB, como “#ffa0b1c3”.DGML usa um subconjunto pequeno de formatos de definição de cor do Windows Presentation Foundation (WPF).Para obter mais informações, Classe de coresconsulte.

Elemento	Formato de exemplo
<DirectedGraph></DirectedGraph> Esse elemento é o elemento raiz de documento direcionado de gráfico (.dgml).Todos os outros elementos de DGML aparecem no escopo deste elemento. A lista a seguir descreve os atributos opcionais que você pode incluir: Background - a cor do plano de fundo do gráfico BackgroundImage - o local de um arquivo de imagem a ser usado como o plano de fundo do gráfico. GraphDirection - quando o gráfico é definido para o layout da árvore (Sugiyama), organizar os nós de modo que a maioria dos links que na direção especificada: TopToBottom, BottomToTop, LeftToRight, ou RightToLeft.Consulte Procurar e reorganizar gráficos de dependência. Layout - definir o gráfico a seguir layouts: None, Sugiyama (layout da árvore), ForceDirected (conjuntos rápidos), ou DependencyMatrix.Consulte Procurar e reorganizar gráficos de dependência. NeighborhoodDistance - quando o gráfico for definido para o layout da árvore ou a conjuntos rápidos layout apresentação, somente os nós que são um número especificado (1-7) de links fora dos nós selecionados.Consulte Procurar e reorganizar gráficos de dependência. Title - o nome do elemento gráfico ZoomLevel - o nível de zoom usado para exibir inicialmente o gráfico.Especifique um valor de ponto flutuante onde 1 é 100%, ou Fit para ajustar o gráfico o tamanho da janela.	<?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> Esse elemento opcional contém uma lista de elementos de <Node/> , que definem nós no gráfico.Para obter mais informações, consulte o elemento de <Node/> . Observação Quando você referencia um nó indefinido em um elemento de <Link/> , o gráfico a seguir cria um elemento de <Node/> automaticamente.	<?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 um único nó.Aparece na lista de elemento de <Nodes><Nodes/> . Esse elemento deve incluir os seguintes atributos: Id - o nome exclusivo do nó e o valor padrão do atributo de Label , se nenhum atributo separado de Label é especificado.Este nome deve corresponder ao atributo de Source ou de Target de link que referencia. A lista a seguir descreve alguns dos atributos opcionais que você pode incluir: Label - o nome para exibição do nó Atributos de estilo.Consulte Aplicar estilos personalizados para nós e a links. Category - o nome de uma categoria que identifica os elementos que compartilham esse atributo.Para obter mais informações, consulte o elemento de <Category/> . Property - o nome de uma propriedade que identifica os elementos que têm o mesmo valor de propriedade.Para obter mais informações, consulte o elemento de <Property/> . Group - se o nó contém outros nós, defina este atributo a Expanded ou a Collapsed para mostrar ou ocultar seu conteúdo.Deve haver um elemento de <Link/> que inclua o atributo de Category="Contains" e especifique o nó pai como o nó de origem e o nó filho como o nó de destino.Consulte Organize nós em grupos. Visibility - definir esse atributo para Visible, a Hidden, ou a Collapsed.Usa System.Windows.Visibility.Consulte Nós oculte seções ou de apresentação. Reference - definir esse atributo para vincular a um documento ou a um URL.Consulte Vincule itens nós.	<?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> Esse elemento contém a lista de elementos de <Link> , que definem os links entre nós.Para obter mais informações, consulte o elemento de <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 um único link que conecta um nó de origem para um nó de destino.Aparece na lista de elemento de <Links></Links> . Observação Se este elemento referencia um nó indefinido, o documento de gráfico cria automaticamente um nó que possui os atributos especificados, se houver. Esse elemento deve incluir os seguintes atributos: Source - o nó de origem de link Target - o nó de destino do link A lista a seguir descreve alguns dos atributos opcionais que você pode incluir: Label - o nome para exibição de link Atributos de estilo.Consulte Aplicar estilos personalizados para nós e a links. Category - o nome de uma categoria que identifica os elementos que compartilham esse atributo.Para obter mais informações, consulte o elemento de <Category/> . Property - o nome de uma propriedade que identifica os elementos que têm o mesmo valor de propriedade.Para obter mais informações, consulte o elemento de <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> Esse elemento contém a lista de elementos de <Category/> .Para obter mais informações, consulte o elemento de <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 um atributo de Category , que é usado para identificar os elementos que compartilham esse atributo.Um atributo de Category pode ser usado para organizar elementos de gráfico, para prevê-los atributos compartilhados com herança, ou para definir metadados adicionais. Esse elemento deve incluir os seguintes atributos: Id - o nome exclusivo de categoria e o valor padrão do atributo de Label , se nenhum atributo separado de Label é especificado. A lista a seguir descreve alguns dos atributos opcionais que você pode incluir: Label - leitor- um nome amigável para a categoria. BasedOn - a categoria pai de <Category/> que herda do elemento atual. No exemplo desse elemento, a categoria de FailedTest herda o atributo de Stroke de categoria de PassedTest .Consulte “para criar categorias hierárquicos” em Atribuir categorias a nós e a links. As categorias também oferecem algum comportamento básico de modelo que controla a aparência dos nós e a links quando são exibidas em um gráfico.Consulte Aplicar estilos personalizados para nós e a links.	<?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> Esse elemento contém a lista de elementos de <Property/> .Para obter mais informações, consulte o elemento de <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 um atributo de Property que você pode usar para atribuir um valor para qualquer elemento ou atributo da DGML, incluindo categorias e outras propriedades. Esse elemento deve incluir os seguintes atributos: Id - o nome exclusivo de propriedade e o valor padrão do atributo de Label , se nenhum atributo separado de Label é especificado. DataType - o tipo de dados armazenados pela propriedade Se você desejar que a propriedade para aparecer na janela de Propriedades , use a propriedade de Label para especificar o nome para exibição da propriedade. Consulte Atribuir propriedades nós e a links.	<?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>

Consulte também

Conceitos

Visualizar dependências de código em gráficos de dependência

Procurar e reorganizar gráficos de dependência