本主題描述圖層模型中的項目和關聯性，而您可以使用程式碼在 Visual Studio Ultimate 中巡覽和更新它們。
如需使用者觀點的圖層圖表的詳細資訊，請參閱圖層圖表：參考和圖層圖表：方針。
本主題所述的 Microsoft.VisualStudio.ArchitectureTools.Extensibility.Layer 模型是較為一般 Microsoft.VisualStudio.GraphModel 模型的正面。 如果您是撰寫功能表命令或手勢擴充功能，請使用 Layer 模型。 如果您是撰寫圖層驗證擴充功能，則使用 GraphModel 較為容易。
異動
當您更新模型時，請考慮將變更納入 ILinkedUndoTransaction 中。 這會將您的變更群組為一個交易。 如果任何變更失敗，則會復原整個交易。 如果使用者復原某項變更，則也會一併復原所有變更。
如需詳細資訊，請參閱如何：使用異動連結模型更新。
using (ILinkedUndoTransaction t =
LinkedUndoContext.BeginTransaction("a name"))
{
// Make changes here ....
t.Commit(); // Don't forget this!
}
內含項目
.png "ILayer 和 ILayerModel 都可以包含 ILayers。")
圖層 (ILayer) 和圖層模型 (ILayerModel) 可以包含「註解」和「圖層」。
圖層 (ILayer) 可以包含在圖層模型 (ILayerModel) 中，也可以巢狀於另一個 ILayer 內。
若要建立註解或圖層，請在適當的容器上使用建立方法。
相依性連結
相依性連結是以物件代表。 而且可以使用任一方向進行巡覽：
.png "ILayerDependencyLink 會連接兩個 ILayers。")
若要建立相依性連結，請呼叫 source.CreateDependencyLink(target)。
註解
註解可以包含在圖層或圖層模型內，也可以連結至任何圖層項目：
.png "註解可以附加至任何圖層項目。")
註解可以連結至任何數目的項目 (包含零個項目)。
若要取得連結至圖層項目的註解，請使用：
ILayerModel model = diagram.GetLayerModel();
IEnumerable<ILayerComment> comments =
model.Comments.Where(comment =>
comment.Links.Any(link => link.Target == layerElement));
警告
ILayer 的 Comments 屬性會取得包含在 ILayer 內的註解。但不會取得與它連結的註解。
在適當的容器上叫用 CreateComment()，以建立註解。
在註解上使用 CreateLink()，以建立連結。
圖層項目
可以包含在模型中的所有類型的項目都是圖層項目：
.png "圖層圖表內容為 ILayerElements。")
屬性
每個 ILayerElement 都有名稱為 Properties 的字串字典。 您可以使用此字典，將任意資訊連結至任何圖層項目。
成品參考
成品參考 (ILayerArtifactReference) 代表圖層與專案項目 (如檔案、類別或資料夾) 之間的連結。 使用者透過將項目從 [方案總管] 或 [架構總管] 拖曳至圖層圖表來建立或加入至圖層時，將會建立成品。 您可以將任意數目的成品參考連結至圖層。
[圖層總管] 中的每個資料列都會顯示成品參考。 如需詳細資訊，請參閱從程式碼建立分層圖。
專注於成品參考的主體類型和方法如下：
ILayerArtifactReference Categories 屬性指出參考哪一種類型的成品 (如類別、可執行檔或組件)。 Categories 決定 Identifier 如何識別目標成品。
CreateArtifactReferenceAsync 會透過 Project 或 ProjectItem 建立成品參考。 這是一個非同步作業。 因此，您通常會提供在建立完成時呼叫的回呼。
「圖層成品參考」不應該與使用案例圖中的「成品」混淆。
圖案和圖表
兩個物件都是用來代表圖層模型中的每個項目：ILayerElement 和 IShape。 IShape 代表圖案在圖表上的位置和大小。 在圖層模型中，每個 ILayerElement 都有一個 IShape，而圖層圖表上的每個 IShape 都有一個 ILayerElement。 IShape 也用於 UML 模型。 因此，不是每個 IShape 都有圖層項目。
同樣地，ILayerModel 會顯示在一個 IDiagram 上。
在自訂命令或手勢處理常式的程式碼中，您可以透過 DiagramContext 匯入，取得目前圖表以及目前圖案選取範圍：
public class ... {
[Import]
public IDiagramContext DiagramContext { get; set; }
...
public void ... (...)
{ IDiagram diagram = this.DiagramContext.CurrentDiagram;
ILayerModel model = diagram.GetLayerModel();
if (model != null)
{ foreach (ILayer layer in model.Layers) { ... }}
foreach (IShape selected in diagram.SelectedShapes)
{ ILayerElement element = selected.GetLayerElement();
if (element != null) ... }}
.png "每個 ILayerElement 都是由 IShape 表示。")
IShape 和 IDiagram 也用來顯示 UML 模型。 如需詳細資訊，請參閱如何：在圖表上顯示模型。