如何：编辑和自定义关系图文档

在 Visual Studio 旗舰版中，您可以通过编辑节点和链接来重点关注定向关系图编辑的关键关系和区域。 这在关系图显示有大量信息时尤其有用。 例如，您可以标识现有软件系统中的主要组件以及这些组件之间的关系。 然后，您可以与团队成员共享和讨论这些重点区域。 有关从代码生成关系图的信息，请参见如何：生成 .NET 代码的依赖项关系图。

若要突出显示感兴趣的区域，您可以选择和筛选节点、将预定义的样式应用于节点和链接，以及将节点组织为组。 可以通过编辑关系图的有向图形标记语言 (DGML) 文件来更进一步地自定义关系图。 例如，您可以编辑该文件中的 DGML 元素以指定自定义样式、为节点和链接分配属性和类别，或将节点链接到文档、URL 和其他 .dgml 文件等项。 有关 DGML 元素的更多信息，请参见了解定向关系图标记语言 (DGML)。

可通过以下方式来编辑关系图：

• 选择节点

• 隐藏或显示节点

• 显示或隐藏链接

• 更改关系图的样式

• 更改节点和链接的样式

• 将样式从一个关系图复制到另一个关系图

• 将节点组织为组

• 为节点和链接分配属性

• 为节点和链接分配类别

• 将项链接到节点

• 创建常用路径的别名

选择节点

隐藏或显示节点

隐藏关系图上的节点可阻止它们在关系图上显示和参与任何布局算法。

通过编辑 .dgml 文件来隐藏节点

1. 右击关系图图面，然后单击**“查看 DGML”**。

   Visual Studio 将打开关系图的 .dgml 文件。

2. 在 <Node/> 元素中，添加下面的特性以隐藏节点：

   Visibility="Hidden"
   

   例如：

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

显示或隐藏链接

可通过指定希望看到的链接的种类来控制关系图上的详细信息量。 关系图显示两种链接：节点之间的直接链接，以及默认情况下隐藏的跨组链接。 跨组链接都是跨不同的组连接节点的单独链接。

如果组处于折叠状态，则关系图会将所有跨组链接聚合为组之间的单个链接。 如果组处于展开状态，您可以在组内选择节点，并且新的跨组链接将出现，并显示该组内的实际依赖关系。

显示或隐藏链接

1. 如果图形工具栏不可见，请在**“视图”上，指向“工具栏”，然后单击“定向关系图”**。

2. 从下表中选择一个任务：

   若要	单击
   始终显示所有跨组链接	显示所有跨组链接
   仅显示连接到所选节点的跨组链接	显示所选节点的跨组链接
   始终隐藏所有跨组链接	隐藏所有跨组链接
   隐藏所有链接（或显示所有链接）	隐藏所有链接 若要显示所有链接，请再次单击“隐藏所有链接”以禁用此模式。

更改关系图的样式

可通过编辑关系图的 .dgml 文件来更改关系图的背景色和边框颜色。 若要更改节点和链接的样式，请参见更改节点和链接的样式。

更改关系图的样式

1. 右击关系图图面，然后单击**“查看 DGML”**。

   Visual Studio 将打开关系图的 .dgml 文件。

2. 在 <DirectedGraph> 元素中，添加以下任何特性以更改其样式：

   若要更改	添加以下特性
   背景色	Background="ColorNameOrHexadecimalValue"
   边框颜色	Stroke="StrokeValue"

   例如：

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

更改节点和链接的样式

您可以更改节点上的图标以及节点和链接的颜色。 可以使用预定义的颜色和图标，也可以通过编辑关系图的 .dgml 文件来指定自定义颜色和图标。 有关更多信息，请参见将自定义样式应用于节点和链接。

例如，您可以选择一种颜色来突出显示具有特定类别或属性的节点和链接。 这样，您将可标识和重点显示关系图的特定区域。

将预定义的颜色或图标应用于具有特定类别或属性的节点

1. 如果看不到**“图例”框，请右击关系图，然后单击“显示图例”**。

2. 在**“图例”**框中，确定节点类别或属性是否显示在列表中。

3. 如果列表未包括类别或属性，请单击**“添加”，指向“节点类别”或“节点属性”**，然后选择类别或属性。

   提示

   若要为节点创建和分配类别，请参见为节点和链接分配类别。 若要为节点创建和分配属性，请参见为节点和链接分配属性。

4. 在**“图例”**框中，单击类别或属性旁边的下拉列表。

5. 使用下表来选择要更改的样式：

   若要更改	Select
   背景色	背景
   轮廓颜色	笔画
   文本颜色	Foreground
   图标	图标

6. 在选取器对话框中，选择以下选项之一：

   若要应用	请执行这些步骤
   颜色集（或图标集）	单击“选择颜色集”（“选择图标集”）下拉列表，然后单击颜色集（或图标集）。 若要恢复为默认颜色（或图标），请在“选择颜色集”（“选择图标集”）下拉列表中单击“无”。
   特定颜色（或图标）	单击类别或属性值下拉列表，然后选择颜色（或图标）。

7. 完成上述操作后，单击**“确定”**。

   提示

   您可以重新排列、删除或暂时禁用“图例”框中的样式。 有关更多信息，请参见修改“图例”框。

将预定义的颜色应用于具有特定类别或属性的链接

1. 如果看不到**“图例”框，请右击关系图，然后单击“显示图例”**。

2. 在**“图例”**框中，确定类别或属性是否显示在列表中。

3. 如果列表未包括类别或属性，请单击**“添加”，指向“链接类别”或“链接属性”**，然后选择类别或属性。

   提示

   若要为链接创建和分配类别，请参见为节点和链接分配类别。 若要为链接创建和分配属性，请参见为节点和链接分配属性。

4. 在**“图例”**框中，单击类别或属性旁边的下拉列表。

5. 使用下表来选择要更改的样式：

   若要更改	Select
   箭头颜色	背景
   轮廓颜色	笔画

6. 在**“颜色集选取器”**框中，选择以下各项之一：

   若要应用	请执行这些步骤
   颜色集	单击“选择颜色集”下拉列表，然后单击颜色集。 若要恢复为默认颜色，请在“选择颜色集”下拉列表中单击“无”。
   特定颜色	单击类型或属性值下拉列表以选择颜色。

7. 完成上述操作后，单击**“确定”**。

   提示

   您可以重新排列、删除或暂时禁用“图例”框中的样式。 有关更多信息，请参见修改“图例”框。

将自定义样式应用于节点和链接

您可以将自定义样式应用于以下各项：

• 单个节点和链接

• 节点和链接组

• 基于特定条件的节点和链接组

将自定义样式应用于单个节点

1. 右击要自定义其样式的节点，然后单击**“查看 DGML”**。

   Visual Studio 将打开关系图的 .dgml 文件，并突出显示该节点的 <Node/> 元素。

2. 在 <Node/> 元素中，添加以下任何特性以自定义其样式：

   若要更改	添加以下特性
   背景色	Background="ColorNameOrHexadecimalValue"
   轮廓	Stroke="ColorNameOrHexadecimalValue"
   轮廓粗细	StrokeThickness="StrokeValue"
   文本颜色	Foreground="ColorNameOrHexadecimalValue"
   图标	Icon="IconFilePathLocation"
   文本大小	FontSize="FontSizeValue"
   文本类型	FontFamily="FontFamilyName"
   文本粗细	FontWeight="FontWeightValue"
   文本样式	FontStyle="FontStyleName" 例如，可以指定 Italic 作为文本样式。
   纹理	Style="Glass" - 或 - Style="Plain"
   形状	Shape

   例如：

   <Nodes>
      <Node Id="MyNode" Background="Green" Stroke="#FF000000"
      Foreground="White" Icon="...\Graph Icons\MyNodeIcon.jpg"/>
   </Nodes>
   

将自定义样式应用于单个链接

1. 在该图形上，将鼠标指针移到相应的链接上，以显示工具提示并确定链接的源节点和目标节点。

2. 右击图形，然后单击**“查看 DGML”**。

   Visual Studio 将打开关系图的 .dgml 文件。

3. 找到包含源节点名称和目标节点名称的 <Link/> 元素。

4. 在 <Link/> 元素中，添加以下任何特性以自定义其样式：

   若要更改	添加以下特性
   箭头颜色	Background="ColorNameOrHexadecimalValue"
   轮廓颜色	Stroke="ColorNameOrHexadecimalValue"
   轮廓粗细	StrokeThickness="StrokeValue"
   轮廓样式	StrokeDashArray="StrokeArrayValues"

   例如：

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

将自定义样式应用于节点或链接组

1. 为节点或链接分配所需的任何类别或属性。

   有关更多信息，请参见为节点和链接分配类别和为节点和链接分配属性。

2. 右击关系图图面，然后单击**“查看 DGML”**。

   Visual Studio 将打开关系图的 .dgml 文件。

3. 如果 <Styles></Styles> 元素不存在，请在 <DirectedGraph></DirectedGraph> 元素下的 <Links></Links> 元素后面添加一个该元素。

4. 在 <Styles></Styles> 元素中的 <Style/> 元素下，指定以下特性：

   • TargetType="Node | Link | Graph"

   • GroupLabel="NameInLegendBox"

   • ValueLabel="NameInStylePickerBox"

   若要将自定义样式应用于所有目标类型，请不要使用条件。

将条件样式应用于节点或链接组

1. 在 <Style/> 元素中，添加一个包含 Expression 特性的 <Condition/> 元素，以指定返回布尔值的表达式。

   例如：

   <Condition Expression="MyCategory"/>
   

   - 或 -

   <Condition Expression="MyCategory > 100"/>
   

   - 或 -

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

   此表达式使用以下 Backus-Naur 形式 (BNF) 语法：

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

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

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

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

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

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

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

   <PropertyGet> ::= Identifier

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

   <Identifier> ::= [^. ]*

   <Literal> ::= 带单引号或双引号的字符串文本

   <Number> ::= 带可选小数点的数字字符串

   您可以指定多个 <Condition/> 元素，这些元素必须均为 true 才能应用样式。

2. 在 <Condition/> 元素后的下一行上，添加一个或多个 <Setter/> 元素，以指定要应用于满足条件的关系图、节点或链接的 Property 特性和固定 Value 特性或者计算所得的 Expression 特性。

   例如：

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

作为一个完整的简单示例，以下条件根据节点的 Passed 类别是设置为 True 还是 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>

下表包括一些您可以使用的示例条件：

<?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\AddIn.png" Shape="None" />
   <Category Id="Test" Icon="..\Icons\Macro.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>

修改“图例”框

您可以重新排列、删除或暂时禁用**“图例”**框中的样式：

1. 右击**“图例”**框中的一种样式。

2. 执行以下任务之一：

   若要	单击
   将样式上移	上移
   将项下移	下移
   删除项	删除
   禁用项	禁用
   重新激活项	启用

将样式从一个关系图复制到另一个关系图

• 右击源关系图的空白区域，单击**“复制图例”**，然后将样式粘贴到目标关系图上。

将节点组织为组

也可以通过编辑关系图的 .dgml 文件来将节点组织为组。

使用现有节点作为组或添加新组

1. 若要使用现有节点作为组，请右击要用作组节点的节点，然后单击**“查看 DGML”**。

   Visual Studio 将打开关系图的 .dgml 文件，并突出显示该节点的 <Node/> 元素。

   - 或 -

   1. 若要添加新组，请右击关系图的空白区域，然后单击**“查看 DGML”**。

   2. 在 <Nodes> 部分添加新的 <Node/> 元素。

2. 在 <Node/> 元素中，添加一个 Group 特性以指定组显示为展开状态还是折叠状态。 例如：

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

3. 在 <Links> 部分，确保对于组节点和其子节点之间的每个关系，都存在具有以下特性的 <Link/> 元素：

   • 一个指定组节点的 Source 特性

   • 一个指定子节点的 Target 特性

   • 一个指定组节点和其子节点之间的 Contains 关系的 Category 特性

   例如：

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

   有关 Category 特性的更多信息，请参见为节点和链接分配类别。

为节点和链接分配属性

可以通过为节点和链接分配属性来组织节点和链接。 例如，可以选择具有特定属性的节点，以便能够对这些节点进行分组、更改它们的样式或隐藏它们。

为节点分配属性

1. 右击节点，然后单击**“查看 DGML”**。

   Visual Studio 将打开关系图的 .dgml 文件，并突出显示该节点的 <Node/> 元素。

2. 在 <Node/> 元素中，指定属性的名称和属性的值。 例如：

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

3. 将 <Property/> 元素添加到 <Properties> 部分以指定特性，例如其可见名称和数据类型：

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

为链接分配属性

1. 在该图形上，将鼠标指针移到相应的链接上，以显示工具提示并确定链接的源节点和目标节点。

2. 右击图形，然后单击**“查看 DGML”**。

   Visual Studio 将打开关系图的 .dgml 文件。

3. 找到包含源节点名称和目标节点名称的 <Link/> 元素。

4. 在 <Node/> 元素中，指定属性的名称和属性的值。 例如：

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

5. 将 <Property/> 元素添加到 <Properties> 部分以指定特性，例如其可见名称和数据类型：

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

为节点和链接分配类别

可以通过为节点分配类别来组织节点。 例如，可以选择位于某些类别中的节点，以便能够对这些节点进行分组、更改它们的样式或隐藏它们。 可以突出显示具有某些类别的链接。 有关更多信息，请参见下列章节：

• 将节点组织为组

• 更改节点和链接的样式

• 隐藏或显示节点

为节点分配类别

• 若要分配预定义的类别（例如**“类别 1”），请右击节点，指向“分类”**，然后单击一个预定义的类别。

- 或 -

• 创建和分配自定义类别：

  • 单击要分类的节点，按 F4 打开**“属性”窗口，在节点的“新建类别”**属性中键入类别的名称，然后按 Enter。

  - 或 -

  1. 右击节点，然后单击**“查看 DGML”**。

     Visual Studio 将打开关系图的 .dgml 文件，并突出显示该节点的 <Node/> 元素。

  2. 在 <Node/> 元素中，添加一个 Category 特性以指定类别的名称。 例如：

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

  3. 向 <Categories> 部分添加一个 <Category/> 元素，以便能够使用 Label 特性来指定该类别的显示文本：

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

为链接分配类别

1. 在该图形上，将鼠标指针移到相应的链接上，以显示工具提示并确定链接的源节点和目标节点。

2. 右击图形，然后单击**“查看 DGML”**。

   Visual Studio 将打开关系图的 .dgml 文件。

3. 找到包含源节点名称和目标节点名称的 <Link/> 元素。

4. 在 <Link/> 元素中，添加一个 Category 特性以指定类别的名称。 例如：

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

5. 向 <Categories> 部分添加一个 <Category/> 元素，以便能够使用 Label 特性来指定该类别的显示文本：

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

可以创建分层类别，来帮助您组织节点并通过使用继承向子类别中添加特性。

创建分层类别

• 为父类别添加一个 <Category/> 元素，然后将 BasedOn 特性添加到子类别的 <Category/> 元素。

  例如：

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

  在此示例中，MyFirstNode 的背景为绿色，因为它的 Category 特性继承 MyParentCategory 的 Background 特性。

将项链接到节点

通过编辑关系图的 .dgml 文件并将 Reference 特性添加到某个节点的 <Node/> 元素，可以将文档或 URL 等项链接到该节点。 Reference 特性指定该内容的路径。 此路径可能是相对于 .dgml 文件位置的路径，也可能是绝对路径。 然后，您可以从关系图上的该节点中打开和查看该内容。

例如，您可能希望链接以下项：

• 若要描述某个类的更改，您可以将工作项、文档或另一个 .dgml 文件的 URL 链接到该类的节点。

• 您可以将层关系图链接到表示软件逻辑体系结构中的层的组节点。

• 若要显示有关公开某接口的组件的更多信息，您可以将组件图链接到该接口的节点。

• 将节点链接到 Team Foundation Server 工作项或 Bug，或链接到与节点相关的某些其他信息。

将项链接到节点

1. 在关系图上，右击节点，然后单击**“查看 DGML”**。

   Visual Studio 将打开关系图的 .dgml 文件，并突出显示该节点的 <Node/> 元素。

2. 执行下表中的任务之一：

   若要链接	请执行这些步骤
   单一项	在 <Node/> 元素中，添加一个 Reference 特性以指定项的位置。 注意 每个 <Node/> 元素只能有一个 Reference 特性。 例如： <Nodes> <Node Id="MyNode" Reference="MyDocument.txt" /> </Nodes> <Properties> <Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" /> </Properties>
   多个项	在 <Node/> 元素中，添加一个新特性以指定每个引用的位置。 在 <Properties> 部分： 为每个新引用类型添加一个 <Property/> 元素。 将 Id 特性设置为新引用特性的名称。 添加 IsReference 特性，并将其设置为 True 以使引用出现在节点的“转到”快捷菜单上。 使用 Label 特性指定节点的“转到”快捷菜单上的显示文本。 例如： <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>

   在关系图上，显示的节点名称带有下划线。

3. 使用 ReferenceTemplate 特性来指定多个引用使用的公共字符串（例如 URL），而不是在引用中重复该字符串。

   ReferenceTemplate 特性为引用的值指定占位符。 在下面的示例中，ReferenceTemplate 特性中的 {0} 占位符将替换为 <Node/> 元素中的 MyFirstReference 和 MySecondReference 特性的值，以生成完整路径：

   <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. 执行下列任务之一以查看引用的项：

   查看	执行以下步骤
   单一项	双击节点。 - 或 - 右击节点，指向“转到”，然后单击相应项。
   多个项	右击节点，指向“转到”，然后单击一项。

创建常用路径的别名

将常用路径替换为别名有助于减小 .dgml 文件的大小和加载或保存该文件所需的时间。 若要创建别名，请在 .dgml 文件的结尾处添加 <Paths></Paths> 部分。 在此部分添加 <Path/> 元素以定义路径的别名：

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

若要从 .dgml 文件中的某个元素引用别名，请用美元符号 ($) 和括号 (()) 将 <Path/> 元素的 Id 值括起来。

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

了解定向图形标记语言 (DGML)

DGML 使用简单 XML 来描述循环和非循环定向关系图。 定向关系图是一组由链接或边缘连接的节点。 可以使用节点和链接来表示网络结构，如软件项目中的元素。 使用 DGML 可执行以下操作：可视化信息、执行复杂性分析或仅浏览和编辑定向关系图。

节点和链接称为关系图元素或简称为元素。 下表描述在 DGML 中使用的元素的种类：

元素	示例格式
<DirectedGraph></DirectedGraph> 此元素是定向关系图 (.dgml) 文档的根元素。 所有其他 DGML 元素将在此元素的范围内出现。 下面的列表描述可包含的可选特性： Background - 关系图的背景色 BackgroundImage - 用作关系图背景的图像文件的位置。 ButterflyMode - 如果为 True，则仅显示与所选节点处于相同路径上的链接节点。 如果未选择节点，则关系图将选择主集线器。 注意 循环链接不会出现在此模式中。而是会复制参与循环关系的节点，以使它们同时出现在所选节点的两侧。距所选节点的距离超过一个级别的依赖关系将不一定按顺序出现，因为关系图布局是根据以所选节点为起点的最短路径确定的。 有关更多信息，请参见如何：在关系图文档中浏览和导航。 GraphDirection - 在关系图设置为树布局 (Sugiyama) 时排列节点，以使大多数链接都按指定的方向流动：TopToBottom、BottomToTop、LeftToRight 或 RightToLeft。 有关更多信息，请参见如何：在关系图文档中浏览和导航。 Layout - 将关系图设置为下列布局：None、Sugiyama（树布局）、ForceDirected（快速群集）或 DependencyMatrix。 有关更多信息，请参见如何：在关系图文档中浏览和导航。 NeighborhoodDistance - 当关系图设置为树布局或快速群集布局时，仅显示那些离开所选节点指定链接数 (1-7) 的节点。 有关更多信息，请参见如何：在关系图文档中浏览和导航。 Title - 关系图的名称 ZoomLevel - 最初显示关系图时使用的缩放级别。 指定一个浮点值（其中 1 表示 100%）或指定 Fit 以使关系图适合窗口的大小。	<?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> 此可选元素包含 <Node/> 元素的列表，这些元素可定义关系图上的节点。 有关更多信息，请参见 <Node/> 元素。 注意 在 <Link/> 元素中引用未定义的节点时，关系图会自动创建 <Node/> 元素。	<?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/> 此元素定义单个节点。 该节点将出现在 <Nodes><Nodes/> 元素列表内。 此元素必须包括以下特性： Id - 节点的唯一名称和 Label 特性的默认值（如果未指定单独的 Label 特性）。 此名称必须与引用它的链接的 Source 或 Target 特性匹配。 下面的列表描述可包含的部分可选特性： Label - 节点的显示名称 样式特性。 有关更多信息，请参见将自定义样式应用于节点和链接。 Category - 标识共享此特性的元素的类别的名称。 有关更多信息，请参见 <Category/> 元素。 Property - 标识具有相同属性值的元素的属性的名称。 有关更多信息，请参见 <Property/> 元素。 Group - 如果节点包含其他节点，请将此特性设置为 Expanded 或 Collapsed 以显示或隐藏其内容。 必须有一个 <Link/> 元素，此元素包含 Category="Contains" 特性并将父节点指定为源节点，而将子节点指定为目标节点。 有关更多信息，请参见将节点组织为组。 Visibility - 将此特性设置为 Visible、Hidden 或 Collapsed。 使用 System.Windows.Visibility。 有关更多信息，请参见隐藏或显示节点。 Reference - 将此特性设置为链接到文档或 URL。 有关更多信息，请参见将项链接到节点。	<?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" ategory="Automobile" /> </Nodes> <Links> <Link ... /> </Links> <Categories> <Category Id="Person" Background="Orange" /> <Category Id="Automobile" Background="Yellow"/> </Categories> </DirectedGraph>
<Links></Links> 此元素包含 <Link> 元素的列表，这些元素可定义两个节点之间的链接。 有关更多信息，请参见 <Link/> 元素。	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Links> <Link ... /> </Links> </DirectedGraph>
<Link/> 此元素定义一个用于将源节点连接到目标节点的链接。 该链接将出现在 <Links></Links> 元素列表内。 注意 如果此元素引用未定义的节点，则关系图文档将自动创建具有指定特性（如果有）的节点。 此元素必须包括以下特性： Source - 链接的源节点 Target - 链接的目标节点 下面的列表描述可包含的部分可选特性： Label - 链接的显示名称 样式特性。 有关更多信息，请参见将自定义样式应用于节点和链接。 Category - 标识共享此特性的元素的类别的名称。 有关更多信息，请参见 <Category/> 元素。 Property - 标识具有相同属性值的元素的属性的名称。 有关更多信息，请参见 <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> 此元素包含 <Category/> 元素的列表。 有关更多信息，请参见 <Category/> 元素。	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Categories> <Category ... /> </Categories> </DirectedGraph>
<Category/> 此元素定义 Category 特性，此特性用于标识共享此特性的元素。 Category 特性可用于组织关系图元素，通过继承提供共享特性或定义其他元数据。 此元素必须包括以下特性： Id - 类别的唯一名称和 Label 特性的默认值（如果未指定单独的 Label 特性）。 下面的列表描述可包含的部分可选特性： Label - 类别的读者友好名称。 BasedOn - 当前元素的 <Category/> 继承自的父类别。 在此元素的示例中，FailedTest 类别从 PassedTest 类别继承其 Stroke 特性。 有关更多信息，请参见为节点和链接分配类别中的“创建分层类别”。 类别还提供一些基本模板行为，这些行为用于控制节点和链接在关系图上显示的外观。 有关更多信息，请参见将自定义样式应用于节点和链接。	<?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> 此元素包含 <Property/> 元素的列表。 有关更多信息，请参见 <Property/> 元素。	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Properties> <Property ... /> </Properties> </DirectedGraph>
<Property/> 此元素定义 Property 特性，此特性可用于将值分配给任何 DGML 元素或特性（包括类别和其他属性）。 此元素必须包括以下特性： Id - 该属性的唯一名称和 Label 特性的默认值（如果未指定单独的 Label 特性）。 DataType - 该属性存储的数据的类型 如果您希望该属性在“属性”窗口中显示，请使用 Label 属性以指定该属性的显示名称。 有关更多信息，请参见为节点和链接分配属性。	<?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>

请参见

概念

如何：生成 .NET 代码的依赖项关系图

其他资源

如何：在关系图文档中浏览和导航

如何：使用依赖项关系图浏览代码