圖層圖表：方針

您可以藉由在 Visual Studio Ultimate 中建立「圖層圖表」(layer diagram) i來描述高階的應用程式架構。 若要確定您的程式碼與此設計一致，請在 Visual Studio Ultimate 或 Visual Studio Premium 驗證您的分層圖和程式碼。 您也可以在建置流程中包含圖層驗證。 請參閱 Channel 9 影片：使用圖層圖表設計和驗證架構。

圖層圖表是什麼?

圖層圖表就像傳統架構圖表一樣會識別主要元件或功能性的設計單位及其相依性。 圖表上的每個節點稱為「層」(layer)，表示命名空間、專案或其他成品的邏輯群組。 您可以繪製應該存在於您設計中的相依性。 與傳統架構圖表不同的是，您可以在原始程式碼中驗證實際的相依性是否符合所指定的預期相依性。 在 Team Foundation Server 上製作正常組建的驗證部分，就可以確保程式碼即使日後變更仍然會繼續依照系統架構。 請參閱 圖層圖表：參考。

下列步驟概述了如何在開發程序內使用圖層圖表。 本主題稍後的章節會描述每個步驟的更多相關詳細資料。 如果您正在開發新的設計，請略過參考現有程式碼的步驟。

注意事項
這些步驟會按大致順序出現。您可能會想要重疊工作、重新排序以符合自己的情況，以及從專案中每個反覆項目的開頭重新瀏覽。

1. 為整個應用程式或其內的圖層建立圖層圖表。

2. 定義圖層以代表應用程式的主要功能區域或元件。 根據這些圖層的功能，例如「簡報」或「服務」來為圖層命名。 如果您具備 Visual Studio 方案，則可以讓每個圖層與成品的集合 (例如專案、命名空間、檔案等等) 建立關聯。

3. 尋找圖層之間的現有相依性。

4. 編輯圖層與相依性以顯示您要讓程式碼反映的更新設計。

5. 設計應用程式的新區域，方法是建立圖層以代表主體架構區塊或元件，並定義相依性以顯示每個圖層如何使用其他圖層。

6. 編輯圖表的版面配置和外觀，協助您與同事一同討論圖表。

7. 針對圖層圖表驗證程式碼以醒目提示程式碼與所需架構之間的衝突。

8. 更新程式碼以符合新的架構。 反覆開發和重構程式碼直到驗證顯示沒有衝突。

9. 在建置流程中包含圖層驗證以確保程式碼繼續依照您的設計。

建立圖層圖表

您必須在模型專案之內建立圖層圖表。 您可以將新的圖層圖表加入至現有的模型專案、為圖層圖表建立新的模型專案，或在相同的模型專案中複製現有的圖層圖表。

請參閱 從程式碼建立分層圖。

定義圖層以代表功能區域或元件

圖層代表「成品」(artifact) 的邏輯群組，例如專案、程式碼檔案、命名空間、類別和方法。 您可以從 Visual C# .NET 和 Visual Basic.NET 專案的成品中建立圖層，或可以透過連結文件 (例如 Word 檔案或 PowerPoint 簡報) 將規格或計劃附加至圖層。 每個圖層都會顯示為圖表上的矩形，並顯示連結到圖層的成品數目。 圖層可以包含巢狀圖層以描述更特定的工作。

一般來說，會根據圖層的函式 (例如，「簡報」或「服務」) 來為圖層命名。 如果成品具有密切相依性，請將它們放在同一圖層。 如果成品可以個別更新或用於個別應用程式，請將它們放在不同的圖層中。 若要了解圖層模式，請造訪「模式和實務」網站，網址為 https://go.microsoft.com/fwlink/?LinkId=145794。

在更新不熟悉的應用程式時，您可以使用相依性圖形來協助您探索及了解程式碼。 這些圖形可以協助您探索程式碼中的叢集和相依性。 您可能也會使用 [架構總管] 探索命名空間和類別 (這通常會正確對應至現有的圖層)。 如此能讓您更輕鬆地將成品指派給圖層。 然後，您就可以使用圖層圖表來協助更新程式碼。

如需詳細資訊，請參閱下列主題：

• 從程式碼建立分層圖

• 對應相依性圖形上整個程式碼的相依性

• 使用架構總管尋找程式碼

尋找圖層之間的現有相依性

只要與某個圖層關聯的成品參考到與另一個圖層關聯的成品，相依性便會存在。 例如，某個圖層中的類別會宣告在另一個圖層中具有類別的變數。 您可以讓相依性進行反向工程以找出現有的相依性。

注意事項
您無法針對特定種類的成品進行其相依性的反向工程。例如，對連結到文字檔的圖層進行反向工程時，無法找出與該圖層之間的任何相依性。若要查看哪些成品具有可以進行反向工程的相依性，請在一個或多個圖層上按一下右鍵，然後按一下 [檢視連結]。在 [圖層總管] 中，檢查 [支援驗證] 資料行。如果成品的這個資料行顯示 [False]，則無法進行該成品的相依性反向工程。

在圖層之間對現有相依性進行反向工程

• 選取一或多個圖層，以滑鼠右鍵按一下選取的圖層，然後按一下 [產生相依性]。

通常，您會看到一些不應該存在的相依性。 您可以編輯這些相依性，以便與預期的設計保持一致。

編輯圖層與相依性以顯示預定設計

若要描述您打算對系統或預期架構進行的變更，請使用下列步驟來編輯圖層圖表。 您也可以考慮先進行一些重構變更來改善程式碼結構，然後再擴充。 請參閱改善程式碼的結構。

改善程式碼的結構

重構變更屬於改良功能，不會影響應用程式的行為，但是可協助讓程式碼變得更容易變更和在日後進行擴充。 結構完善的程式碼具有易於抽象至圖層圖表的設計。

例如，如果您為程式碼中每個命名空間建立圖層，然後對相依性進行反向工程，則圖層之間應該會有最小一組的單向相依性。 如果您使用類別或方法做為圖層來建立更詳細的圖表，則結果應該也會有相同的特性。

如果不是這樣，那麼程式碼就會較難在其生命週期中有所變更，並且會較不適合使用圖層圖表進行驗證。

設計應用程式的新區域

當您著手開發新專案或新專案的新區域時，可以繪製圖層與相依性，以便有助您先識別主要元件，再著手開發程式碼。

• 在圖層圖表中顯示可識別的架構模式 (如果可能的話)。 例如，描述桌面應用程式的圖層圖表可能包括簡報、網域邏輯和資料儲存區等圖層。 涵蓋應用程式內單一功能的圖層圖表可能具有例如模型、檢視和控制器等的圖層。 如需這類模式的詳細資訊，請參閱模式和實務：應用程式架構。

  如果您經常建立類似的模式，請建立自訂工具。 請參閱 如何：定義自訂模型工具箱項目。

• 為每個圖層建立程式碼成品，例如命名空間、類別或元件。 這可讓您更容易地遵循程式碼，並將程式碼成品連結至圖層。 一旦建立每個成品後，請將它連結至適當的圖層。

• 您不必將大部分的類別和其他成品連結至圖層，因為其會落在較大的成品，例如您已連結至圖層的命名空間。

• 為新功能建立新圖表。 一般而言，會有一個或多個描述整個應用程式的圖層圖表。 如果您要在應用程式內設計新功能，請勿加入或變更現有的圖表。 相反地，請建立自己圖表，以反映程式碼的新組件。 新圖表中的圖層可能包括簡報、網域邏輯和新功能的資料庫層。

  在建置應用程式時，會針對整體圖表和更詳細的功能圖表來驗證您的程式碼。

編輯版面配置以便展示和討論

若要協助您識別圖層與相依性，或與小組成員進行討論，請以下列方式編輯圖表的外觀和版面配置：

• 變更圖層的大小、圖形和位置。

• 變更圖層和相依性的色彩。

  • 選取一或多個圖層或相依性、按一下滑鼠右鍵，然後按一下 [屬性]。 在 [屬性] 視窗中，編輯 [色彩] 屬性。

比對圖表驗證程式碼

若已編輯圖表，您可以隨時手動針對程式碼驗證圖表，或在每次執行本機組建或 Team Foundation Build 時自動驗證。

請參閱：

• 使用圖層圖表驗證程式碼

• 在建置流程中包含圖層驗證

更新程式碼以符合新的架構

通常，會在您第一次針對更新的圖層圖表驗證程式碼時出現錯誤。 這些錯誤可以有數個原因：

• 成品指派給錯誤的圖層。 在此情況下，請移動成品。

• 類別之類的成品以與架構發生衝突的方式使用另一個類別。 在此情況下，請重構程式碼以移除相依性。

若要解決這些錯誤，請更新程式碼直到驗證時不再出現錯誤為止。 這通常是反覆的程序。 如需有關這些錯誤的詳細資訊，請參閱使用圖層圖表驗證程式碼。

注意事項
隨著您開發或重構程式碼，您可能會有新成品要連結至圖層圖表。不過，這可能不是必要的，比方說在您有代表現有命名空間的圖層，而新的程式碼只會將更詳細的資料加入至這些命名空間時。

在開發過程中，您可以隱藏驗證期間已報告過的某些衝突。 例如，您可能會想要隱藏已經處理的錯誤，或是與特定情節無關的錯誤。 當您隱藏錯誤時，最好在 Team Foundation 中記錄工作項目。 若要執行這項工作，請參閱使用圖層圖表驗證程式碼。

在建置流程中包含圖層驗證

若要確保程式碼的日後變更符合圖層圖表，請在您的方案標準建置流程中包含圖層驗證。 不論其他小組成員何時建置方案，只要程式碼與圖表圖層中的相依性之間有任何差異，將會報告為建置錯誤。 如需有關在建置流程中包含圖層驗證的詳細資訊，請參閱使用圖層圖表驗證程式碼。

請參閱

概念

圖層圖表：參考

從程式碼建立分層圖