编辑和自定义依赖项关系图
可以编辑依赖项关系图,而不会影响基础代码。 当您希望关注焦点项目或将有关代码时,的想法这是有用。 例如,使用属性、类或组,显示感兴趣的区域,您可以选择节点和筛选它们,更改节点和链接的样式,隐藏或删除节点和组织节点。
您可以自定义图形进一步通过编辑关系图的定向图形标记语言 (.dgml) 文件。 例如,您可以编辑元素指定自定义样式,分配属性和类别为节点和链接,或对项目,如文档,URL 的节点链接,或其他关系图。
备注
Visual Studio 通过删除它们清理所有未使用的 DGML 元素和特性,当保存 .dgml 文件时。当您手动添加新链接时,将自动创建节点元素。当保存 .dgml 文件时,已添加到元素的所有属性可能会按字母顺序重新排列自身。有关 DGML 元素的更多信息,请参见了解定向关系图标记语言 (DGML)。
要求
最终的 Visual Studio,Visual Studio 高级专业版、Visual Studio professional
若要创建依赖项关系图,您必须具有最终的 Visual Studio。 请参见 在依赖项关系图上可视化代码依赖项。
主题内容
选择节点或链接
对节点或链接重命名
隐藏或显示节点和链接
添加节点和链接
将注释添加到关系图
删除节点
组节点
将关系图
更改关系图的样式
更改节点或链接的样式
将样式从一个关系图复制到另一个关系图
为节点和链接分配属性
为节点和链接分配类别
与节点或链接项
创建常用路径的别名
选择节点或链接
若要 |
执行这些步骤 |
---|---|
选择所有未选定节点 |
打开选定节点的快捷菜单。 选择 选择,插入选定内容。 |
选择与选定的节链接的其他节点 |
打开选定节点的快捷菜单。 选择 选择 和以下操作之一:
|
对节点或链接重命名
选择节点或链接。 按 F2。 在编辑框显示时,对节点或链接重命名。
如果该标签可见,请选择该标签。
隐藏或显示节点和链接
隐藏节点从参与保留这些布局算法。 默认情况下,跨组链接隐藏。 跨组链接是连接跨组节点的单独的链接。 如果组处于折叠状态,则关系图聚合所有跨组链接到组之间的单个链接。 当展开一个组并选择的节点在组中,跨组链接在该组中将出现并显示依赖项。
警告
在共享在最终的 Visual Studio 中创建人使用 Visual Studio premium 或 Visual Studio professional 的关系图之前,请确定对 unhide 所有节点或跨组链接希望其他发现。否则,这些用户不能对 unhide 项。
隐藏或显示节点
若要 |
执行这些步骤 |
---|---|
隐藏所选节点 |
|
隐藏未选定节点 |
|
显示隐藏的节点 |
|
通过编辑 .dgml 文件来隐藏节点 |
|
显示或隐藏链接
若要 |
在关系图工具栏上,打开 更改链接在关系图上的呈现方式 列表或打开关系图快捷菜单。 选择: |
---|---|
始终显示跨组链接 |
显示所有跨组链接 该隐藏组之间的链接。 |
显示所选节点的跨组链接仅 |
显示所选节点的跨组链接 |
始终隐藏跨组链接 |
隐藏跨组链接 |
隐藏所有链接(或显示所有链接) |
隐藏所有链接 若要显示所有链接,请选择 隐藏所有链接 禁用此模式。 |
添加节点和链接
添加新的未定义的节点 |
执行这些步骤 |
---|---|
在当前指针位置 |
在何处选择关系图的一个位置将新的节点。 按 插入。 |
该链接到所选节点 |
|
这与现有节点链接到当前焦点 |
按直到要链接具有焦点节点的 选项卡。 按 Alt+移动+插入。 |
添加节点。 |
执行这些步骤 |
---|---|
在解决方案中的项目 |
|
项与关系图上的节点相关 |
打开节点的快捷菜单。 选择 显示 和感兴趣的关系的种类。 对于程序集,选择:
对于选件类,请选择:
对于方法中,选择:
对于字段中,选择:
|
生成 .NET 程序集 (.dll 或 .exe) 或二进制文件 |
使用 体系结构资源管理器 查找并拖动项和关系到关系图上。 |
添加现有节点之间的链接
选择源节点。
工具栏启动位于节点之上显示。
在工具栏上,选择 创建从节点接下来请单击中的此节点的新链接 。 选择目标节点。
链接显示两个节点之间。
将注释添加到关系图
选择要添加链接注释的节点。
工具栏启动位于节点之上显示。
在工具栏上,选择 使用指向所选节点的新链接创建新的注释节点 。
键入注释。 若要键入在新行,请按 移动+Enter。
删除节点
可以从关系图中删除节点,而不会影响基础代码。 若要删除节点,选择节点,然后按 删除 键。 当删除节点时,其定义从 DGML (.dgml) 文件中移除。
当您从的组中删除节点,重新提取子级 按钮 显示在组中。 若要检索缺少节点,选择 重新提取子级 。 创建通过编辑 DGML,将未定义的节点,或者使用最终 Visual Studio 的早期版本的关系图,不支持此功能。
警告
在共享创建使用最终的 Visual Studio 中的人使用 Visual Studio premium 或 Visual Studio professional 的关系图之前,请确保您希望其他发现的所有节点都显示在关系图。否则,这些用户无法检索已删除的节点。
组节点
若要 |
执行这些步骤 |
---|---|
显示容器节点作为组节点或叶节点 |
若要显示容器节点是叶节点,选择节点。 打开您选择的快捷菜单。 选择 组,转换为叶。 若要显示容器节点作为组节点,选择节点。 打开您选择的快捷菜单。 选择 组,转换为组。 若要显示任何叶节点作为组节点,打开关系图的快捷菜单。 选择 组,打开分组。 若要显示所有组节点是叶节点,打开关系图的快捷菜单。 选择 组,关闭分组。 |
添加一个节点到组 |
拖到组上的节点。 还可以拖动节点在组外。 |
添加一个节点到非组节点 |
您可以将所有节点变为组。 拖到目标节点上的节点。 |
组选定节点 |
|
具有特定类别或属性对节点进行分组 |
|
依据节点的属性值对节点进行分组 |
|
移除组 |
选择要移除的组或组。 打开您选择的快捷菜单。 选择 组,移除组。 |
从节点的父组开始移除节点,直至其祖父组,或者,如果节点没有祖父组,则移除组外部的节点 |
选择要移动的节点。 打开您选择的快捷菜单。 选择 组,从父级移除。 |
分组节点通过编辑关系图的 .dgml 文件
若要将节点变为组,打开节点的快捷菜单。 选择 GoTo,DGML。
Visual Studio 将打开关系图的 .dgml 文件并显示该节点的 <Node/> 元素。
- 或 -
添加新组:
打开关系图的空白区域的快捷菜单。 选择 GoTo,DGML。
在 <Nodes> 部分添加新的 <Node/> 元素。
在 <Node/> 元素中,添加一个 Group 特性以指定组显示为展开状态还是折叠状态。 例如:
<Nodes> <Node Id="MyFirstGroup" Group="Expanded" /> <Node Id="MySecondGroup" Group="Collapsed" /> </Nodes>
在 <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 特性的更多信息,请参见为节点和链接分配类别。
将关系图
可以通过复制并粘贴关系图之间的节点将关系图。 如果节点标识符匹配,则粘贴节点对象就象合并操作。 若要使此任务更加容易,请将您在同一文件夹中要可视化的所有程序集或二进制文件,以便每个程序集或二进制文件的完整路径相同要合并的每个关系图的。
或者,您可以创建要通过执行以下步骤之一进行可视化的程序集或二进制文件的单个关系图:
将程序集或双精度到同一个关系图。
- 或 -
打开 体系结构资源管理器。 在 文件系统下,选择 选择文件 浏览,选择,然后打开该程序集或二进制文件。 若要优化关系图,选择要可视化的特定项。 完成后,选择。体系结构资源管理器 工具栏的 创建新的关系图从所有选定节点文档。
更改关系图的样式
可通过编辑关系图的 .dgml 文件来更改关系图的背景色和边框颜色。 若要更改节点和链接的样式,请参见更改节点和链接的样式。
从打开关系图的快捷菜单图面。 选择 GoTo,DGML。
Visual Studio 将打开关系图的 .dgml 文件。
在 <DirectedGraph> 元素中,添加以下任何特性以更改其样式:
若要更改
添加以下特性
背景色
Background="ColorNameOrHexadecimalValue"
边框颜色
Stroke="StrokeValue"
例如:
<DirectedGraph Background="Green" xmlns="https://schemas.microsoft.com/vs/2009/dgml" > ... ... </DirectedGraph>
更改节点和链接的样式
您可以更改节点上的图标以及节点和链接的颜色。 可以使用预定义的颜色和图标,也可以通过编辑关系图的 .dgml 文件来指定自定义颜色和图标。 将自定义样式应用于节点和链接参见。
例如,您可以选择一种颜色来突出显示具有特定类别或属性的节点和链接。 这样,您将可标识和重点显示关系图的特定区域。
将预定义的颜色或图标应用于具有特定类别或属性的节点
如果 图例 框中不可见,请打开关系图的快捷菜单。 选择 显示图例。
在**“图例”**框中,确定节点类别或属性是否显示在列表中。
如果列表未包括类别或属性中,选择在 图例 框中的 +、节点类别 或 节点属性和该类别或属性。
该类别或属性现在显示在 图例 框。
备注
若要为节点创建和分配类别,请参见为节点和链接分配类别。若要为节点创建和分配属性,请参见为节点和链接分配属性。
在 图例 框中,打开在该类别或属性旁边的下拉列表。
使用下表来选择要更改的样式:
若要更改
Choose
背景色
背景
轮廓颜色
笔划
文本颜色
Foreground
图标
图标
颜色集选取器 框中显示供您选择颜色 (或图标)。
在 颜色集选取器 对话框中,执行下列操作之一:
若要应用
执行这些步骤
颜色集 (或图标
打开 选择颜色 (或 图标) 设置 列表。 选择颜色集 (或图标)。
若要恢复为默认颜色值 (或图标),在 选择颜色 (图标) 设置 列表中,选择 无。
特定颜色(或图标)
打开类别或属性值列表。 选择一种颜色 (或图标)。
备注
您可以重新排列、删除或暂时禁用“图例”框中的样式。修改声明框参见。
将预定义的颜色应用于具有特定类别或属性的链接
如果 图例 框中不可见,请打开关系图的快捷菜单。 选择 显示图例。
在**“图例”**框中,确定类别或属性是否显示在列表中。
如果列表未包括类别或属性中,选择在 图例 框中的 +、链接类别 或 链接属性和该类别或属性。
该类别或属性现在显示在 图例 框。
备注
若要为链接创建和分配类别,请参见为节点和链接分配类别。若要为链接创建和分配属性,请参见为节点和链接分配属性。
在 图例 框,请在该类别或属性旁边打开列表。
选择 边框 更改链接的轮廓和箭头颜色。
颜色集选取器 框中显示供您选择颜色。
在 颜色集选取器 框中,执行以下操作之一:
若要应用
执行这些步骤
颜色集
打开 选择颜色设置 列表。 选择颜色集。
若要恢复为默认颜色值,在 选择颜色集 列表中,选择 无。
特定颜色
打开该类型或属性值列表中选择颜色。
备注
您可以重新排列、删除或暂时禁用“图例”框中的样式。修改声明框参见。
将自定义样式应用于节点和链接
您可以将自定义样式应用于以下各项:
单个节点和链接
节点和链接组
基于特定条件的节点和链接组
将自定义样式应用于单个节点
打开要自定义其样式的节点的快捷菜单。 选择 GoTo,DGML。
Visual Studio 将打开关系图的 .dgml 文件并显示该节点的 <Node/> 元素。
在 <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 属性设置为 None 并将 Icon 属性设置为具有图标文件的路径。
Shape="ShapeFilePathLocation"
例如:
<Nodes> <Node Id="MyNode" Background="#FF008000" Stroke="#FF000000" Foreground="#FFFFFFFF" Icon="...\Icons\Globe.png"/> </Nodes>
将自定义样式应用于单个链接
在关系图上,将鼠标指针在链接的顶部。 出现工具提示并标识源节点和链接的目标节点。 (键盘:按 Tab 直到焦点在链接。)
打开关系图的快捷菜单。 选择 GoTo,DGML。
Visual Studio 将打开关系图的 .dgml 文件。
找到包含源节点名称和目标节点名称的 <Link/> 元素。
在 <Link/> 元素中,添加以下任何特性以自定义其样式:
若要更改
添加以下特性
轮廓和箭头颜色
Stroke="ColorNameOrHexadecimalValue"
轮廓粗细
StrokeThickness="StrokeValue"
轮廓样式
StrokeDashArray="StrokeArrayValues"
例如:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" Background="Green" Stroke="#FF000000" StrokeDashArray="2,2"/> </Links>
将自定义样式应用于节点或链接组
为节点或链接分配所需的任何类别或属性。
提示
如果您有重复大多数节点或链接中的样式,可能要考虑应用于这些类别节点或链接,然后将样式应用于该类别。有关更多信息,请参见为节点和链接分配类别和为节点和链接分配属性。
打开关系图的快捷菜单图面。 选择 GoTo,DGML。
Visual Studio 将打开关系图的 .dgml 文件。
如果 <Styles></Styles> 元素不存在,请在 <DirectedGraph></DirectedGraph> 元素下的 <Links></Links> 元素后面添加一个该元素。
在 <Styles></Styles> 元素中的 <Style/> 元素下,指定以下特性:
TargetType="Node | Link | Graph"
GroupLabel="NameInLegendBox"
ValueLabel="NameInStylePickerBox"
若要将自定义样式应用于所有目标类型,请不要使用条件。
将条件样式应用于节点或链接组
在 <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/>元素,必须都为真应用样式。
在 <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>
下表包括一些您可以使用的示例条件:
修改“图例”框
您可以重新排列、删除或暂时禁用**“图例”**框中的样式:
打开一个样式的快捷菜单在 图例 框。
执行以下任务之一:
若要
Choose
将样式上移
上移
将项下移
下移
删除项
删除
禁用项
禁用
重新激活项
启用
将样式从一个关系图复制到另一个关系图
确定 图例 框显示在源关系图。 如果不可见,请打开源关系图的空白区域的快捷菜单。 选择 显示图例。
打开 图例 框中的快捷菜单。 选择 复制图例。
粘贴到目标关系图上的说明。
为节点和链接分配属性
可以通过为节点和链接分配属性来组织节点和链接。 例如,可以选择具有特定属性的节点,以便能够对这些节点进行分组、更改它们的样式或隐藏它们。
为节点分配属性
打开节点的快捷菜单。 选择 GoTo,DGML。
Visual Studio 将打开关系图的 .dgml 文件并显示该节点的 <Node/> 元素。
在 <Node/> 元素中,指定属性的名称和属性的值。 例如:
<Nodes> <Node Id="MyNode" MyPropertyName="PropertyValue" /> </Nodes>
将 <Property/> 元素添加到 <Properties> 部分以指定特性,例如其可见名称和数据类型:
<Properties> <Property Id="MyPropertyName" Label="My Property" DataType="System.DataType"/> </Properties>
为链接分配属性
在关系图上,将鼠标指针在链接的顶部。 出现工具提示并标识源节点和链接的目标节点。 (键盘:按 选项卡,直到焦点在链接。)
打开关系图的快捷菜单。 选择 GoTo,DGML。
Visual Studio 将打开关系图的 .dgml 文件。
找到包含源节点名称和目标节点名称的 <Link/> 元素。
在 <Node/> 元素中,指定属性的名称和属性的值。 例如:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" MyPropertyName="PropertyValue" /> </Links>
将 <Property/> 元素添加到 <Properties> 部分以指定特性,例如其可见名称和数据类型:
<Properties> <Property Id="MyPropertyName" Label="My Property Name" DataType="System.DataType"/> </Properties>
为节点和链接分配类别
可以通过为节点分配类别来组织节点。 例如,可以选择位于某些类别中的节点,以便能够对这些节点进行分组、更改它们的样式或隐藏它们。 可以突出显示具有某些类别的链接。 有关更多信息,请参见下列章节:
组节点
更改节点和链接的样式
隐藏或显示节点
为节点分配类别
- 若要分配预定义的类别 (例如,类别 1(1),打开节点的快捷菜单。 选择 分类 和预定义的类别。
- 或 -
创建和分配自定义类别:
- 选择要分类的节点。 按 F4 打开 属性 窗口。 键入在节点的 新建类别 特性中的类名称。 按 Enter。
- 或 -
打开节点的快捷菜单。 选择 GoTo,DGML。
Visual Studio 将打开关系图的 .dgml 文件并显示该节点的 <Node/> 元素。
在 <Node/> 元素中,添加一个 Category 特性以指定类别的名称。 例如:
<Nodes> <Node Id="MyNode" Category="MyCategory" /> </Nodes>
向 <Categories> 部分添加一个 <Category/> 元素,以便能够使用 Label 特性来指定该类别的显示文本:
<Categories> <Category Id="MyCategory" Label="My Category" /> </Categories>
为链接分配类别
在该图形上,将鼠标指针移到相应的链接上,以显示工具提示并确定链接的源节点和目标节点。 (键盘:按 选项卡,直到焦点在链接。)
打开关系图的快捷菜单。 选择 GoTo,DGML。
Visual Studio 将打开关系图的 .dgml 文件。
找到包含源节点名称和目标节点名称的 <Link/> 元素。
在 <Link/> 元素中,添加一个 Category 特性以指定类别的名称。 例如:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" Category="MyCategory" </Links>
向 <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 特性。
与节点或链接项
可以链接到项目,如文档或 URL,为节点或链接到通过编辑关系图的 .dgml 文件并添加 Reference 属性为节点的 <Node/> 元素或链接的 <Link/> 元素。 然后可以打开和查看从节点或链接的该目录。 Reference 特性指定该内容的路径。 此路径可能是相对于 .dgml 文件位置的路径,也可能是绝对路径。
警告
如果使用相对路径,因此,.dgml 文件移到其他位置,则这些路径将不再解决。当您尝试打开并查看该链接的内容,一条错误,内容将无法查看将生成。
例如,您可能希望链接以下项:
若要描述某个类的更改,您可以将工作项、文档或另一个 .dgml 文件的 URL 链接到该类的节点。
您可以将层关系图链接到表示软件逻辑体系结构中的层的组节点。
若要显示有关公开某接口的组件的更多信息,您可以将组件图链接到该接口的节点。
与 Team Foundation server 的工作项或 bug 链接节点,或者与节点相关的某些其他信息。
将项链接到节点
在关系图上,打开节点的快捷菜单。 选择 GoTo,DGML。
Visual Studio 将打开关系图的 .dgml 文件并显示该节点的 <Node/> 元素。
执行下表中的任务之一:
若要链接
执行这些步骤
单一项
在 <Node/> 或 <Link/> 元素中,添加一 Reference 属性指定项目的位置。
说明只能有每个元素的 Reference 属性。
例如:
<Nodes> <Node Id="MyNode" Reference="MyDocument.txt" /> </Nodes> <Properties> <Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" /> </Properties>
多个项
在 <Node/> 或 <Link/> 元素中,添加一个新特性指定每个引用的位置。
在 <Properties> 部分:
为每个新引用类型添加一个 <Property/> 元素。
将 Id 特性设置为新引用特性的名称。
添加 IsReference 特性并将其设置为 True 其设置为项目中的 GoTo 快捷菜单。
使用 Label 属性指定显示文本在项目的 GoTo 快捷菜单。
例如:
<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>
在关系图上,显示的节点名称带有下划线。 当您打开该节点或链接的快捷菜单,您将看到包含您的链接的项目中选择的 GoTo 快捷菜单。
使用 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>
若要查看引用的项目或项从关系图,请打开快捷菜单节点或链接的。 选择 GoTo 然后该项目。
创建常用路径的别名
将常用路径替换为别名有助于减小 .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 中使用的元素的种类:
备注
在编辑 .dgml 文件时,IntelliSense 可帮助您标识对每个元素及其值可用的特性。若要指定特性中的颜色,请使用常用颜色的名称,如“Blue”或 ARGB 十六进制值(如“#ffa0b1c3”)。DGML 使用一小部分 Windows Presentation Foundation (WPF) 颜色定义格式。有关更多信息,请参见 Colors 类。