編輯和自訂相依性圖形
您可以編輯相依性圖形,而不會影響基礎程式碼。 這在您想要將焦點放在主要項目或交換關於程式碼的想法時可能會很有用。 例如,若要加強標示感興趣的區域,您可以選擇節點並篩選它們,改變節點和連結的樣式,隱藏或刪除節點,並透過屬性、分類或群組來組織節點。
您還可以透過編輯圖形的 Directed Graph Markup Language (.dgml) 檔案來自訂圖形。 例如,您可以編輯元素來指定自訂樣式,指定節點和連結的屬性和分類,或將節點連至例如文件、 URL 或其他圖形等項目。
注意事項 |
---|
Visual Studio 在您儲存 .dgml 檔案時會刪除未使用的 DGML 項目和屬性。它也會在您手動加入新的連結時自動建立節點項目。當您儲存 .dgml 檔案時,任何加入至項目的屬性可能會自動按照字母順序重新排列。如需 DGML 項目的詳細資訊,請參閱了解有向圖形標記語言 (DGML)。 |
需求
Visual Studio Ultimate、Visual Studio Premium、Visual Studio Professional
若要建立相依性圖形,您必須擁有 Visual Studio Ultimate。 請參閱 根據相依性圖形顯現程式碼相依性。
本主題內容
選取節點或連結。
重新命名節點或連結
隱藏或顯示節點和連結
加入節點或連結
加入註解至圖形中
刪除節點
群組節點
合併圖形
變更圖形的樣式
變更節點和連結的樣式
將樣式從一個圖形複製到另一個圖形
指派屬性給節點和連結
指派分類給節點和連結
將項目連結至節點或連結
建立常用路徑的別名
選取節點或連結。
若要 |
請執行這些步驟 |
---|---|
選取所有未選取的節點 |
開啟所選節點的捷徑功能表。 選取 [選取], [反向選擇]。 |
選取連結至已選取節點的其他節點 |
開啟所選節點的捷徑功能表。 選取 [選取] 和下列其中一項:
|
重新命名節點或連結
選取節點或連結。 請按 F2。 當編輯方塊出現時,請為節點或連結重新命名。
如果標籤為可見的,請選取標籤。
隱藏或顯示節點和連結
隱藏節點以防止它們參與配置演算法。 根據預設,跨群組連結是隱藏的。 跨群組連結是連接跨群組之節點的個別連結。 當群組摺疊起來時,圖形會將所有跨群組連結彙總成單一的群組間連結。 當您展開一個群組並選取群組內的節點時,跨群組連結會出現並在群組中並顯示相依性。
警告
在您要與使用 Visual Studio Premium 或 Visual Studio Professional的人分享使用 Visual Studio Ultimate 建立的圖表之前,請確保為取消隱藏所有您想分享給其他人的節點或跨群組連結。否則,使用者將無法對這些項目取消隱藏。
隱藏或顯示節點
若要 |
請執行這些步驟 |
---|---|
隱藏選取的節點 |
|
隱藏未選取的節點 |
|
顯示隱藏的節點 |
|
編輯 .dgml 檔案來隱藏節點 |
|
若要顯示或隱藏連結
若要 |
在圖形工具列上,開啟 [變更連結在圖形上的呈現方式] 清單或開啟圖表捷徑功能表。 選取 |
---|---|
任何時候都顯示所有跨群組連結 |
顯示所有跨群組連結 這個隱藏了群組之間的彙總連結。 |
只顯示選取的節點的跨群組連結 |
顯示所選取節點上的跨群組連結 |
任何時候都隱藏跨群組連結 |
隱藏跨群組連結 |
隱藏所有連結 (或顯示所有連結) |
隱藏所有連結 若要顯示所有連結,請再次選取 [隱藏所有連結] 以關閉此模式。 |
加入節點或連結
加入新的未定義節點 |
請執行這些步驟 |
---|---|
從目前的游標位置開始 |
在圖形上選取要放置新節點的地方。 按一下 [插入] 。 |
將與所選節點連接 |
|
將目前的焦點與存在的節點加入連結 |
按 [Tab] 直到您想要加入連結的節點已經得到焦點。 按 [Alt] + [移位] + [插入] 。 |
欲加入節點 |
請執行這些步驟 |
---|---|
方案中的項目 |
|
圖形上與節點相關的項目 |
開啟節點的捷徑功能表。 選取 [顯示] 以及您感興趣的關聯性。 對組件而言,選取:
對於類別而言,選取:
對於方法,選取:
如是欄位中,選取:
|
已編譯的 .NET 組件 (.dll 或 .exe) 或二進位檔。 |
使用 [架構總管] 尋找並拖曳和圖形相關聯的項目。 |
將現有的節點之間的連結
選取來源節點。
工具列始在節點上方出現。
在工具列上,選取 [從此節點往所選取的節點建立連結] 。 選取目標節點。
連結出現於兩節點之間。
加入註解至圖形中
選取您想要加入註解的節點。
工具列始在節點上方出現。
在工具列上,選取 [為所選取的節點加入新的註解] 。
輸入您的註解。 若要輸入新的一行,請按 SHIFT + Enter 。
刪除節點
您可以從圖形刪除節點而不影響底下的程式碼。 若要刪除節點,請選取節點,然後按 刪除 鍵。 當您刪除節點時,其定義從 DGML (.dgml) 檔案中移除。
當您從群組中刪除節點, [重新擷取子系] 按鈕 會出現在群組裏。 若要回復不見的節點,請選取 [重新擷取子系]。 藉由編輯 DGML ,加入未定義的節點,或使用較早版本的 Visual Studio Ultimate ,無法支援此相容性。
警告
在您分享使用 Visual Studio Ultimate 的圖形給 Visual Studio Premium 或 Visual Studio Professional 的使用者之前,請確認您想讓其他人瀏覽的節點在圖形上是可見的。否則,那些使用者將無法取得被刪除的節點。
群組節點
若要 |
請執行這些步驟 |
---|---|
將容器節點顯示為群組節點或葉節點 |
若要顯示容器節點為葉節點,請選取節點。 開啟您所選項目的捷徑功能表。 選取 [群組], [轉換為葉]。 若要顯示容器節點為群組節點,請選取節點。 開啟您所選項目的捷徑功能表。 選取 [群組], [轉換為群組]。 若要顯示所有葉節點為群組節點,開啟圖形的捷徑功能表。 選取 [群組], [開啟群組]。 若要顯示所有群組節點為葉節點,開啟圖形的捷徑功能表。 選取 [群組], [關閉群組]。 |
將節點加入至群組 |
將節點拖曳至群組。 您也可以將節點拖曳至群組之外。 |
增加一個節點至非群組節點。 |
您可以將任何節點轉換成群組。 拖曳節點到目標節點上。 |
群組中選取的節點 |
|
群組節點具有特定分類或屬性 |
|
根據節點的屬性值組成節點群組 |
|
移除群組 |
選取您想要移除的群組。 開啟您所選項目的捷徑功能表。 選取 [群組], [移除群組]。 |
從節點的父群組至上一層父群組 (如果沒有上一層父群組,則是群組外部) 移除節點 |
選取您要移動的節點。 開啟您所選項目的捷徑功能表。 選取 [群組], [從母系移除]。 |
透過編輯圖形的 .dgml 檔案群組節點
若要將節點轉換成群組,請開啟節點的捷徑功能表。 選取 [移至] 、 [DGML] 。
Visual Studio 開啟圖形的 .dgml 檔案並反白顯示<Node/> 該節點的項目。
-或-
若要加入新群組:
隨即開啟圖形的空白區域的捷徑功能表。 選取 [移至] 、 [DGML] 。
在 <Nodes> 區段中,加入新的 <Node/> 項目。
在 <Node/> 項目中加入 Group 屬性,指定群組呈現為展開或摺疊的狀態。 例如:
<Nodes> <Node Id="MyFirstGroup" Group="Expanded" /> <Node Id="MySecondGroup" Group="Collapsed" /> </Nodes>
在 <Links> 區段中,針對群組節點與其子節點之間的每一個關聯性,確定其中存在具有下列屬性的 <Link/> 項目:
Source 屬性,指定群組節點
Target 屬性,指定子節點
Category 屬性,指定群組節點與其子節點之間的 Contains 關聯性
例如:
<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 檔案,變更圖形的背景色彩和框線色彩。 若要變更節點和連結的樣式,請參閱變更節點和連結的樣式。
開啟從圖形介面的捷徑功能表。 選取 [移至] 、 [DGML] 。
Visual Studio 開啟圖形的 .dgml 檔案。
在 <DirectedGraph> 項目中,加入下列任何屬性以變更其樣式:
若要變更
請加入下列屬性
背景色彩
Background="ColorNameOrHexadecimalValue"
框線色彩
Stroke="StrokeValue"
例如:
<DirectedGraph Background="Green" xmlns="https://schemas.microsoft.com/vs/2009/dgml" > ... ... </DirectedGraph>
變更節點和連結的樣式
您可以變更節點的圖示以及節點和連結的色彩。 您可以使用預先定義的色彩和圖示,也可以藉由編輯圖形的 .dgml 檔案來指定自訂色彩。 請參閱 套用自訂樣式至節點和連結 (Apply Custom Styles to Nodes and Links) 。
例如,您可以選擇色彩來標示具有特定分類或屬性的節點和連結。 這樣就能識別和注意圖形的特定區域。
若要將預先定義的色彩或圖示套用至具有特定分類或屬性的節點
如果看不到 [圖例] 方塊,請開啟圖形的捷徑功能表。 選取 [顯示圖例] 。
在 [圖例] 方塊中,查看清單是否包含節點分類或屬性。
如果清單不包含分類或屬性,請在 [圖例] 方塊裏選擇 [+] , [節點分類] 或 [節點屬性] ,以及其分類或屬性。
在 [圖例] 方塊中將會出現分類或屬性。
注意事項 若要建立和指派分類給節點,請參閱指派分類給節點和連結。若要建立屬性並指派給節點,請參閱指派屬性給節點和連結。
在 [圖例] 方塊,在分類或屬性旁開啟下拉式選單。
使用下表選取您想要變更的樣式:
若要變更
Choose
背景色彩
背景
外框色彩
筆觸
文字色彩
Foreground
圖示
圖示
[色彩集選擇器] 方塊顯示供您選取色彩 (或圖示) 。
在 [色彩集選擇器] 方塊中,選擇下列其中一項:
若要套用
請執行這些步驟
一組色彩 (或圖示
開啟 [選取色彩。] (或 [圖示]) [設定] 清單。 選取一組色彩 (或圖示) 。
若要回復預設色彩 (或圖示),請在 [選取色彩] ([選取圖示設定]) [設定] 下拉式清單中按一下 [無] 。
特定色彩 (或圖示)
開啟分類或屬性值的清單。 選取色彩 (或圖示)。
注意事項 您可以重新整理、刪除或暫時停用 [圖例] 方塊中的樣式。請參閱 修改圖形方塊 。
若要將預先定義的色彩套用至具有特定分類或屬性的連結
如果看不到 [圖例] 方塊,請開啟圖形的捷徑功能表。 選取 [顯示圖例] 。
在 [圖例] 方塊中,查看清單是否包含分類或屬性。
如果清單沒有包含分類或屬性,請選取 [圖例] 方塊裏的 [+] ,[連結分類] 或 [連結屬性] ,以及其分類或屬性。
在 [圖例] 方塊中將會出現分類或屬性。
注意事項 若要建立分類並指派給連結,請參閱指派分類給節點和連結。若要建立屬性並指派給連結,請參閱指派屬性給節點和連結。
在 [圖例] 方塊中,開啟分類或屬性旁邊的下拉式清單。
選取 [線段] 以改變連結的輪廓和箭頭顏色。
[色彩集選擇器] 方塊會出現供您選擇顏色。
在 [色彩集選擇器] 方塊中,選擇下列其中一項:
若要套用
請執行這些步驟
一組色彩
開啟 [選取色彩設定] 清單。 選取一組色彩。
若要回復預設色彩,請在 [選取色彩設定] 下拉式清單中按一下 [無]。
特定色彩
開啟型別或屬性值清單以選取一個顏色。
注意事項 您可以重新整理、刪除或暫時停用 [圖例] 方塊中的樣式。請參閱 修改圖形方塊 。
將自訂樣套用至節點和連結
您可以將自訂樣式套用至下列項目:
單一節點和連結
節點和連結的群組
根據特定條件組成的節點和連結群組
若要將自訂樣式套用至單一節點
請為您想要自訂的節點開啟捷徑功能表。 選取 [移至] 、 [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 直到連結取得焦點。)
開啟圖形的快捷選單。 選取 [移至] 、 [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>
若要將自訂樣式套用至一組節點或連結
將您想要的任何分類或屬性指派給節點或連結。
提示
如果您在許多不同的節點或連結之間使用了重覆的樣式,您可能可以考慮套用一個分類至那些節點或連結上並將該樣式設置予該分類。如需詳細資訊,請參閱指派分類給節點和連結和指派屬性給節點和連結。
開啟圖形介面的捷徑功能表。 選取 [移至] 、 [DGML] 。
Visual Studio 開啟圖形的 .dgml 檔案。
如果 <Styles></Styles> 項目不存在,請在 <Links></Links> 項目之後的 <DirectedGraph></DirectedGraph> 項目底下加入該項目。
在 <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/>項目,都必須是 true 套用樣式。
在 <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
將樣式向上移動
上移
將項目向下移動
下移
刪除項目
刪除
停用項目
停用
重新啟動項目
啟用
將樣式從一個圖形複製到另一個圖形
確保 [圖例] 方塊出現於來源圖形上。 如果看不到,請在來源圖形的空白區域開啟捷徑功能表。 選取 [顯示圖例] 。
開啟 [圖例] 方塊的捷徑功能表。 選取 [複製圖例] 。
貼上圖例至目標圖表中。
指派屬性給節點和連結
您可以指派屬性給節點和連結,將它們組織起來。 例如,您可以選取具有特定屬性的節點,以便組成群組、變更樣式或隱藏節點。
若要將屬性指派給節點
開啟節點的捷徑功能表。 選取 [移至] 、 [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>
若要將屬性指派給連結
在圖形上,將滑鼠指標移至連結上方。 工具提示隨即出現並識別連結的來源節點和目標節點。 (鍵盤: 按 Tab ,直到連結取得焦點。)
開啟圖形的快捷選單。 選取 [移至] 、 [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],開啟節點的捷徑功能表。 選取 [分類] 和預先定義的分類。
-或-
若要建立和指派自訂分類:
- 選取要分類的節點。 按 F4 開啟 屬性 視窗。 輸入節點的 [新增分類] 屬性的分類名稱。 請按 ENTER 鍵。
-或-
開啟節點的捷徑功能表。 選取 [移至] 、 [DGML] 。
Visual Studio 開啟圖形的 .dgml 檔案並反白顯示<Node/> 該節點的項目。
在 <Node/> 項目中加入 Category 屬性,以指定分類的名稱。 例如:
<Nodes> <Node Id="MyNode" Category="MyCategory" /> </Nodes>
將 <Category/> 項目加入至 <Categories> 區段,如此即可使用 Label 屬性來指定該分類的顯示文字:
<Categories> <Category Id="MyCategory" Label="My Category" /> </Categories>
若要將分類指派給連結
在此圖形上,將滑鼠指標移至連結上方,以顯示工具提示並識別連結的來源節點和目標節點。 (鍵盤: 按 Tab ,直到連結取得焦點。)
開啟圖形的快捷選單。 選取 [移至] 、 [DGML] 。
Visual Studio 開啟圖形的 .dgml 檔案。
尋找同時包含來源節點與目標節點名稱的 <Link/> 項目。
在 <Link/> 項目中加入 Category 屬性,以指定分類的名稱。 例如:
<Links> <Link Source="MyFirstNode" Target="MySecondNode" Category="MyCategory" </Links>
將 <Category/> 項目加入至 <Categories> 區段,如此即可使用 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 工作項目或臭蟲,或一些其他有關節點的資訊。
若要將項目連結到節點
在圖形上,開啟節點的捷徑功能表。 選取 [移至] 、 [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 以使參考出現在項目的 [移至] 捷徑功能表。
使用 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>
顯示在圖形中的節點名稱會加上底線。 當您開啟節點或連結的捷徑功能表,您可以看見 [移至] 包含連結項目的捷徑功能表供您選擇。
使用 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>
若要檢視參考的項目從圖形,請開啟捷徑功能表節點或連結的。 選取 [執行] 然後項目。
建立常用路徑的別名
以別名取代常用路徑,有助於縮減 .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) 色彩定義格式。如需詳細資訊,請參閱色彩類別 (英文)。 |