Compartilhar via

Editar e personalizar gráficos de dependência

  • Artigo

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çãoObservaçã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

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

Para

Executar estas etapas

Selecione todos os nós de-selecionados

Abra o menu de atalho para os nós selecionados.Escolha Selecionar, Inverter seleção.

Selecione os nós adicionais que vinculam a selecionados

Abra o menu de atalho para os nós selecionados.Escolha Selecionar e um destes procedimentos:

  • Para selecionar os nós adicionais que vinculam diretamente para o nó selecionado, escolha Dependências de entrada.

  • Para selecionar os nós adicionais que vinculam diretamente do nó selecionado, escolha Dependências de saída.

  • Para selecionar os nós adicionais que vinculam diretamente para o nó selecionado, escolha Ambos.

  • Para selecionar além de todos os nós que vinculam para o nó selecionado, escolha Subgraph conectado.

  • Além disso para selecionar todos os filhos do nó selecionado, escolha Filhos.

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

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.

Observação de cuidadoCuidado

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

Executar estas etapas

Nós selecionados couro cru

  1. Nós selecionados que você deseja usar.

  2. Abra o menu de atalho para os nós selecionados ou para o gráfico.Escolha Selecionar, Cru selecionado couro.

Ocultar nós de-selecionados

  1. Nós selecionados que você deseja localizar visível.

  2. Abra o menu de atalho para os nós selecionados ou para o gráfico.Escolha Selecionar, Ocultar Não Selecionados.

Mostrar os nós ocultos

  • Para mostrar todos os nós ocultos em um grupo, certifique-se que o grupo é expandido primeiro.Escolha Reexibir filhosReexibir o ícone de filhos filho no canto superior esquerdo do grupo.

  • Para mostrar todos os nós ocultos, abra o menu de atalho para o gráfico.Escolha Seleção, Reexibir tudo.

Ocultar nós editando o arquivo de .dgml

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

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

  2. No elemento de <Node/> , adicione o atributo a seguir para ocultar o nó:

    Visibility="Hidden"

    Por exemplo:

    <Nodes>
   <Node Id="MyNode" Visibility="Hidden"/>
</Nodes>

Para mostrar ou ocultar os links

Para

Na barra de ferramentas do gráfico, abra a lista de Alterar como links são processados no gráfico ou abra o menu de atalho do gráfico. Escolha:

Mostrar os links do grupo cruzado em todas as vezes

Mostrar todos os links entre grupo

Isso oculta links agregados entre grupos.

Mostrar somente links entre grupo para nós selecionados

Mostrar os links do grupo cruzado em nós selecionados

Ocultar os links do grupo cruzado em todas as vezes

Ocultar os links entre grupo

Ocultar todos os links (ou mostrar todos os links)

Ocultar todos os links

Para mostrar todos os links, escolha Ocultar todos os links novamente para desativar esse modo.

Para adicionar um novo nó indefinido

Executar estas etapas

No local atual do ponteiro

Selecione um local no gráfico onde colocar o novo nó.Pressione Inserir.

Esse links para o nó selecionado

  1. Selecione o nó de origem.

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

    Barra de ferramentas de gráfico de dependência

  2. Na barra de ferramentas, escolha Crie um nó com a mesma categoria que este nó e adicionar um novo linkBarra de ferramentas de gráfico - criar o nó com link.

  3. Escolha um local no gráfico para colocar o novo nó.

    (Teclado: Pressione Tabulação até o nó de que você deseja vincular tem o foco, e para pressione ALT+Inserir.)

Esse vincula a um nó existente com foco atual

Pressione Tabulação até o nó a que você deseja vincular tem o foco.PressioneShift+ ALT+Inserir.

Para adicionar nós para

Executar estas etapas

Itens no solution

  1. Localizar o item em Gerenciador de Soluções.Use a caixa de pesquisa de Gerenciador de Soluções ou procure a solução.Para procurar seu código em Gerenciador de Soluções, consulte Exibindo a estrutura de código.

    DicaDica
    Para localizar itens que tem dependências em um tipo ou um membro, abra o menu de atalho para o tipo ou membro em Gerenciador de Soluções.Escolha o relacionamento que você interesses.Gerenciador de Soluções mostra apenas esses itens com as dependências especificadas.

  2. Arraste itens de seu interesse para a superfície do gráfico.

    Para incluir a hierarquia do recipiente pai para os itens selecionados para usar o Visual Studio final, pressione e segure a tecla de CTRL quando você arrastar itens para o gráfico.

    - ou -

    Em Gerenciador de Soluções, abra a lista de Crie um novo documento de gráfico… .Escolha Adicionar ao Gráfico de Dependência Ativa.Para adicionar a hierarquia do recipiente pai, escolha Adicione ao gráfico ativa de dependência com hierarquia de retenção em vez disso.

    O Visual Studio adiciona nós para os itens de alto nível de código em sua seleção.Para ver se um nó contém itens, mova o ponteiro do mouse no nó de modo que a viga (^) aparece.Escolha a viga (^) para expanda o nó.Para expandir todos os nós, abra o menu de atalho para o gráfico.Escolha Grupo, Expandir Tudo.

    ObservaçãoObservação
    Este comando não está disponível para expandir todos os grupos gera problemas de um gráfico inutilizável ou de memória.

Itens relacionados aos nós no gráfico

Abra o menu de atalho para o nó.Escolha Mostrar e o tipo de relacionamento que você interesses.

Para um assembly, escolha:

  • Assemblies referenciados: Adicionar conjuntos que faz referência a esse assembly.Os módulos (assemblies) externos aparecem no grupo de Externos .

  • Referenciando assemblies: Adicionar conjuntos na solução que fazem referência a esse assembly.

Para uma classe, escolha:

  • Tipos Base: Para uma classe, adicione a classe base e interfaces implementadas.

    Para uma interface, adicione as interfaces base.

  • Tipos derivados: Para uma classe, adicione as classes derivadas.

    Para uma interface, adicione as interfaces derivados e as classes ou estruturas os implementando.

  • Todos os tipos base: Adicione a hierarquia de classe base ou interface recursivamente.

  • Todos os tipos derivados: Para uma classe, adicione todas as classes derivadas recursivamente.

    Para adicionar uma interface, todas as interfaces derivados e implementar classes ou estruturas recursivamente.

  • Hierarquia de retenção: Adicione a hierarquia do recipiente pai.

  • Tipos usados: Adicionar todas as classes e seus membros que usa essa classe.

  • Usado - Por tipos: Adicionar todas as classes e seus membros que usam essa classe.

Para um método, escolha:

  • Hierarquia de retenção: Adicione a hierarquia do recipiente pai.

  • Método chamado: Adicionar métodos que este método chama.

  • Chamar-Por métodos: Adicionar métodos que chama esse método.

  • Métodos substituídos nos tipos de base: Para um método que substitui outros métodos ou implementa o método de interface, adicione todos os métodos abstratos ou virtuais nas classes base que são substituídas e, se houver, o método de interface que é implementado.

  • Campos referenciados: Adicione os campos que referencia este método.

Para um campo, escolha:

  • Hierarquia de retenção: Adicione a hierarquia do recipiente pai.

  • Referenciando métodos: Adicionar métodos que referenciam este campo.

Módulos compilados .NET (.dll ou .exe) ou binários

Use Arquitetura Explorer para localizar e arraste itens e relacionamentos para o gráfico.

  1. Selecione o nó de origem.

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

    Barra de ferramentas de gráfico de dependência

  2. Na barra de ferramentas, escolha Criar novo link deste nó para qualquer nó que você clicar em seguidaBarra de ferramentas de gráfico - criar vínculo.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ó.

    Barra de ferramentas de gráfico de dependência

  2. Na barra de ferramentas, escolha Crie um novo nó de comentário com um novo link para o nó selecionadoBarra de ferramentas de gráfico - criar comentário com link.

  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 Buscar novamente o ícone de filhos de Filhos de Refetch aparece no grupo.Para recuperar nós ausente, escolha Nova Busca de FilhosBuscar novamente o ícone 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.

Observação de cuidadoCuidado

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

Executar estas etapas

Mostrar os nós de contêiner como nós ou nós folha do grupo

Para mostrar os nós de contêiner como nós folha, selecione os nós.Abra o menu de atalho para a seleção.Escolha Grupo, Converter a folhear.

Para mostrar os nós de recipiente como nós de grupo, selecione os nós.Abra o menu de atalho para a seleção.Escolha Grupo, Converter em Grupo.

Para mostrar todos os nós folha como nós de grupo, abra o menu de atalho para o gráfico.Escolha Grupo, Ativar o agrupamento.

Para mostrar todos os nós de grupo como nós folha, abra o menu de atalho para o gráfico.Escolha Grupo, Desativar o agrupamento.

Adicione um nó para um grupo

Arraste o nó no grupo.

Você também pode arrastar nós fora de um grupo.

Adicione um nó em um nó que não são de grupo

Você pode converter qualquer nó em um grupo.Arraste o nó no nó de destino.

Agrupar nós selecionados

  1. Selecione os nós que você deseja agrupar.

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

    Barra de ferramentas de gráfico de dependência

  2. Na barra de ferramentas, escolha Agrupar os nós selecionadosFerramentas de gráfico - grupo selecionado.

    - ou -

    Abra o menu de atalho para a seleção.Escolha Grupo, Adicionar Grupo Pai.

  3. Abra o menu de atalho para o novo grupo.Escolha Propriedades.Na propriedade de Rótulo , renomeie o grupo.

Agrupar os nós que têm categorias ou propriedades específicas

  1. No menu de Arquitetura , escolha Janelas, Arquitetura Explorer.

  2. Use a arquitetura Explorer para localizar e selecionar todos os nós que você deseja agrupar.

    Consulte Localizar o código com o Explorer de Arquitetura.

  3. No lado direito da coluna atual, escolha a coluna recolhida de ação para para expandi-la.(Teclado: Pressione Tabulação para mover o foco até que a coluna de ação recolhida se expanda.)

    ObservaçãoObservação
    A coluna ação é realçado quando você move o ponteiro, ou foco, sobre ele.

  4. Na coluna de ação, clique Contido por.(Teclado: Pressione Tabulação para mover o foco e então use as teclas de direção até que a relação Contido por está selecionada.)

  5. A próxima coluna, arraste os grupos de contêiner para o gráfico.

  6. Abra o menu de atalho para o gráfico.Escolha Grupo, Ativar o agrupamento.

Agrupar nós de acordo com os valores de propriedade

  1. Salve o elemento gráfico como um arquivo de .dgml no disco.

  2. No menu de Arquitetura .Escolha Janelas, Arquitetura Explorer.

  3. Em Arquitetura Explorer, em Sistema de arquivos, escolha Selecionar Arquivos.

  4. Na próxima coluna, selecione o arquivo salvo de .dgml

  5. Use Arquitetura Explorer para localizar e selecionar todos os nós que você deseja agrupar.

    Consulte Localizar o código com o Explorer de Arquitetura.

  6. No lado direito da coluna atual, escolha a coluna recolhida de ação para para expandi-la.(Teclado: Pressione Tabulação para mover o foco até que a coluna de ação recolhida se expanda.)

    ObservaçãoObservação
    A coluna ação é realçado quando você move o ponteiro sobre ele.

  7. Na coluna de ação, em Agrupamento, escolha Agrupar por Propriedades.(Teclado: Pressione Tabulação para mover o foco e então use as teclas de direção até que o comando Agrupar por Propriedades seja selecionado.)

  8. Na próxima coluna, selecione as propriedades que você deseja usar como grupos.

    A coluna aparece e a seguir mostra os valores de propriedade disponíveis.

  9. A próxima coluna, arraste os grupos de valor de propriedade para o gráfico.

  10. Abra o menu de atalho para a superfície de gráfico.Escolha Grupo, Ativar o agrupamento.

Remova os grupos

Selecione o grupo ou grupos que você deseja remover.Abra o menu de atalho para a seleção.Escolha Grupo, Remover Grupo.

Remover os nós do grupo pai até o avô, ou para fora do grupo, se não têm nenhum grupo de avô

Selecione os nós que você deseja mover.Abra o menu de atalho para a seleção.Escolha Grupo, Remova pai.

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>

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çãoObservaçã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çãoObservação

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

  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çãoObservaçã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çãoObservação

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

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>

  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>

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

    DicaDica

    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.

  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:

Para

Exemplo DGML

Defina o tamanho da fonte em função do número de linhas de código, que também altera o tamanho do nó.Este exemplo usa uma única expressão condicional para definir várias propriedades, FontSize e FontFamily.

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

Definir a cor do plano de fundo de um nó com base na propriedade de Coverage .Os estilos são avaliados na ordem em que eles aparecem, semelhante às instruções de if-else .

Nesse exemplo:

  1. Se Coverage é > 80, defina a propriedade de Background para verde.

  2. Se mais Coverage é > 50, defina a propriedade de Background a uma máscara de laranja com base no valor da propriedade de Coverage .

  3. Outro conjunto da propriedade Background a uma máscara de vermelho com base no valor da propriedade de Coverage .

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

Defina a propriedade de Shape a None de modo que o ícone substitui a forma.Use a propriedade de Icon para especificar o local de ícone.

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

Ee842619.collapse_all(pt-br,VS.110).gifModifique 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.

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>

  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>

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>

  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.

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.

Observação de cuidadoCuidado

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çãoObservaçã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

    1. No elemento de <Node/> ou de <Link/> , adicione um novo atributo para especificar o local de cada referência.

    2. Na seção de <Properties> :

      1. Adicione um elemento de <Property/> para cada novo tipo de referência.

      2. Defina o atributo de Id o nome do novo atributo de referência.

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

      4. 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çãoObservaçã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çãoObservaçã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çãoObservaçã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