根據循序圖顯現程式碼內容及其關聯性

若要視覺化程式碼如何實作特定方法，請在 Visual Studio Ultimate 中從方法建立「順序圖表」(sequence diagram)。 循序圖會將物件之間的互動顯示為一系列生命線和訊息。 生命線代表物件的執行個體，而訊息則代表這些物件之間的方法呼叫。 您可以從 Visual C# .NET 或 Visual Basic .NET 程式碼產生順序圖表，但是無法從跨多個應用程式共用的專案產生。

產生的順序圖表會顯示類似於 UML 順序圖表上的項目。 從程式碼產生的順序圖表會獨立於 UML 模型存在，而且可加入至任何 .NET 專案。 反之，您以手動方式繪製的 UML 順序圖表則永遠是您在其中建立圖表之模型的一部分。 如需詳細資訊，請參閱 UML 順序圖表：參考。

• 從原始程式碼產生順序圖表

• 探索順序圖表上的程式碼

• 編輯圖表以提出設計變更建議

• 從圖表移至程式碼

• 將順序圖表連結至工作項目

• 與其他圖表的關聯性

• 疑難排解順序圖表

從原始程式碼產生順序圖表

1. 在 Visual Studio Ultimate 中，開啟含有方法定義的程式碼檔案。

2. 移至方法定義，在編輯器中按一下滑鼠右鍵，然後選擇 [產生循序圖]。

3. 在 [最大呼叫深度] 方塊中，指定您要查看呼叫的最大層級。 例如，如果您只想要查看第一層呼叫，請將最大呼叫深度層級指定為 1。

   

   注意事項
   順序圖表就會將第二層呼叫顯示成沒有目標生命線的訊息，稱為遺失訊息。產生圖表之後，您可以展開特定的遺失訊息。如需遺失訊息的詳細資訊，請參閱 UML 順序圖表：參考。

4. 在 [將呼叫包含於] 底下，從下表中選擇一個範圍：

   若要查看	Choose
   立即專案中項目的呼叫	[目前專案]
   方案中項目的呼叫	[目前方案 ] (預設值)
   方案內部和外部項目的呼叫	[方案和外部參考]

   例如，您可以僅對目前專案中的項目進行方法呼叫的檢查，從簡單的順序圖表開始著手。 您可以產生顯示跨方案項目之呼叫的新範圍，藉以擴展圖表的範圍。 如果您想要查看不在方案中之項目的呼叫，就必須產生包含外部參考的圖表。

5. 在 [排除對以下的呼叫] 底下，您可以透過省略對下列項目的呼叫，進一步簡化圖表：

   若要省略對這些項目的呼叫	選取
   屬性和事件	[屬性和事件] (預設值)
   System 命名空間	[系統命名空間] (預設值)
   特定的命名空間	[其他命名空間]，然後在方塊中輸入命名空間，並使用逗號 (,) 分隔各命名空間。 請勿使用萬用字元 (*)，因為不支援萬用字元。

   若要包含對這些項目的呼叫，請清除其對應的核取方塊。

6. 如果您想要將圖表加入目前的專案，請核取這個方塊。

7. 當您完成時，請選擇 [確定] 以產生循序圖。

   如需有關產生順序圖表之問題的詳細資訊，請參閱疑難排解順序圖表。

   注意事項
   產生的順序圖表不會顯示陣列宣告。

若要在且不影響程式碼的情況下，識別和溝通想要進行的變更，您可以探索和修改產生的順序圖表。 例如，您可以加入新的生命線、訊息、互動使用和片段。 若要針對要在對應的程式碼上執行的工作建立和追蹤工作，您可以建立工作項目並連結到圖表項目。 如需詳細資訊，請參閱連結模型項目和工作項目。

探索順序圖表上的程式碼

順序圖表可以協助您探索程式碼，並將它展示給其他人。 若要針對這些目的完成最有用的圖表，請在產生圖表時，使用不同的範圍進行實驗。 您也可以在產生圖表之後，加以修改。 例如，您可以刪除與展示和討論設計無關的訊息。

您可以對順序圖表進行下列變更。

編輯圖表以提出設計變更建議

您可以變更圖表，並加入和刪除項目來協助您考慮替代設計。 您也可以將圖表的部分複製到您已在 UML 模型專案中建立的 UML 順序圖表。 這樣做可讓您將生命線與 UML 模型的類型、元件和行動產生關聯。

下表摘要說明適用於描述設計提議的變更。 如需詳細資訊，請參閱 UML 順序圖表：方針。

轉換為	請執行這些步驟
反白顯示生命線、訊息和其他項目	變更項目的 [色彩] 屬性。 -或- 將 [註解] 連結至項目： 在 [工具箱] 中，選擇 [註解]，然後在圖表上項目附近的位置按一下。 在 [工具箱] 中，選擇 [註解連結]，然後在圖表上，選取註擇，再選擇項目。
移動生命線	將生命線拖曳至圖表的不同區域。 若要移動具有遺失或尋得訊息的生命線群組，請遵循以下步驟來選取生命線，然後移動它們： 在生命線周圍繪製矩形。 -或- 在選擇每個生命線時按住 CTRL 鍵。 注意事項 如果您使用 [全選] 或 CTRL+A 來選取所有生命線，然後移動它們，則不會移動附加至這些生命線的任何遺失或尋得訊息。如果發生此案例，則您可以分別移動這些訊息。
移動和重新排列訊息	在圖表上，向上或向下拖曳訊息。 選取一則訊息，然後： 若要調整訊息的位置，請使用向上鍵和向下鍵。 若要變更訊息的順序，請使用 CTRL+向上鍵和 CTRL+向下鍵。
加入生命線	選擇 [工具箱] 中的 [生命線]，然後選擇圖表。
加入訊息	在 [工具箱] 中，選擇 [同步] 或 [非同步] 訊息。 若要加入「尋得訊息」(Found Message) 或「遺失訊息」(Lost Message)，請使用 [非同步] 訊息。 尋得訊息是來自未知的事件來源，而遺失訊息則會廣播至未知的收件者。 在圖表上，選擇來源生命線。 選擇目標生命線。 -或- 若要建立尋得訊息或遺失訊息，請分別在來源生命線後面或前面選擇圖表上的空白區域。 輸入訊息的新名稱。
將生命線和訊息複製到其他圖表或從中複製	複製並貼上生命線。 系統也會一併複製這些生命線之間的訊息。 注意事項 當您將生命線從模型專案中的 UML 順序圖表複製到產生的順序圖表時，可能只會顯示生命線標頭，或者您可能必須調整其色彩。若要修正這個問題，請選取貼上的生命線，並設定其 [色彩] 屬性。
將訊息放入合併片段中	選取一則或多則訊息。 開啟您所選項目的捷徑功能表，指向 [範圍陳述式]，然後選擇合併片段的類型。 您可以使用合併片段來代表訊息的替代順序、迴圈以及其他撰寫。
將訊息移至新的圖表	開啟訊息的捷徑功能表，然後選擇 [移至圖表]。 如此就會建立新的圖表，其中包含此訊息及其附帶訊息。 在原始圖表上，此訊息會由 [互動使用] 所取代。
複製圖表	在 [方案總管] 中複製圖表，或在 [Windows 檔案總管] 中複製這些檔案。 每個圖表都有兩個相關聯的檔案。 您可以使用任何 Visual Studio Ultimate 執行個體來編輯產生的順序圖表，而且可以使用 Visual Studio Ultimate 或 Visual Studio Premium 來讀取這種圖表。
不反白顯示特定手動變更，例如加入項目和名稱變更	開啟循序圖介面的捷徑功能表，然後選擇 [屬性]。 將 [顯示手動變更] 屬性設為 [False]。

從圖表移至程式碼

將順序圖表連結至工作項目

若要協助規劃實作變更的工作，您可以將順序圖表上任何種類的項目連結至 Team Foundation Server 中的工作項目。 在您開始之前，請確定您已經連接到 Team Foundation Server。 如需詳細資訊，請參閱連結模型項目和工作項目。

使用所產生順序圖表的指導方針

當您要使用產生的順序圖表來探索程式碼時，下列方針可能很有用。

探索程式碼

您可以產生相依性圖表來取得大型程式碼主體中主要群組和相依性的整體概觀。 然後，產生順序圖表，以便將焦點放在設計的個別部分。 如需詳細資訊，請參閱對應相依性圖形上整個程式碼的相依性。

解譯圖表

建立圖表的演算法會用符號代替可執行程式碼。 這項技術無法涵蓋某些情況。 尤其，這些情況包括：

• 兩個或多個生命線可能會出現在圖表中，而執行中程式碼只處理單一執行個體。 一般而言，系統會針對每則訊息產生個別的目標生命線。

• 生命線的類型就是程式碼中宣告的類型，即使您的程式碼永遠使用子類型也一樣。

將焦點放在設計層面

• 請選擇一個設計層面來放置焦點。 您可以產生不同的圖表，以便將焦點放在不同的層面，並且在任何工作階段中建立圖表檔案的複本。

• 若要取得清楚公開設計層面的有用圖表，您可能必須使用命名空間篩選和產生來進行實驗。

• 請刪除與焦點層面無關的訊息，然後展開相關訊息來顯示更多詳細資料。

• 除非代表共同作業物件群組之生命線的內部互動與您要放置焦點的層面有關，否則請使用 [摺疊] 命令，將這些生命線組成群組。

更新設計

• 您可以使用版本控制，在圖表上進行共同作業。 我們建議您在編輯圖表時加以鎖定，使同時間只有一位人員能夠編輯。

• 您通常可以使用產生的順序圖表來識別讓程式碼難以變更或調整的現有程式碼功能。 例如，您可能會注意到某個生命線會傳送所有訊息，但是其他生命線只會回應訊息，而不會傳送它們自己的訊息。 請考慮此物件所完成的工作是否能夠更有效地在其他物件之間分割。 每個物件類別都應該具有清楚定義的單一工作。 一般而言，這項原則會讓您更容易識別哪些程式部分必須在使用者的需求變更時加以變更，或是在應用程式的不同變體中重新排列這些部分。

• 當您擁有將焦點放在設計特定層面的圖表時，請建立此圖表的複本並加以編輯，以便建立變更的替代提議。

• 您可以將產生之順序圖表的項目複製到 UML 順序圖表中。 您必須先在 UML 模型專案內部建立 UML 順序圖表。 然後，您就可以針對更新設計的不同檢視建立模型，而且可以將生命線連結至模型中的元件或類別。 您也可以擴充互動以包含外部行動。

疑難排解順序圖表

下列表格描述在產生順序圖表時可能發生的問題和可能的解決方式：

void ILinkedWorkItemExtension.OnWorkItemCreated( ) {}

請參閱

參考

UML 順序圖表：參考

概念

視覺化程式碼

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

從程式碼建立分層圖