搭配程式碼註解和捷徑使用 [工作清單]

Visual Studio 中的 [工作清單] 工具可讓您追蹤使用 TODO 和 HACK 或自訂權杖等權杖的程式碼註解。 您也可以使用這項功能來管理將您直接帶到程式碼中預先定義位置的工作捷徑。 根據預設，[工作清單] 會在 Visual Studio 互動式開發環境 (IDE) 的應用程式視窗底部開啟：

如果您沒有看到 [工作清單] 視窗，請選取 [檢視]>[工作清單]，或使用鍵盤捷徑 [Ctrl]+\、[T]。 如同 Visual Studio IDE 中的其他功能視窗，您可以將 [工作清單] 視窗移至 IDE 介面上的任何位置。

使用預先定義權杖

Visual Studio 會掃描您的程式碼以取得註解標記和權杖，以準備 [工作清單] 內容。 有數個預先定義的權杖可供 C/C++、C# 和 Visual Basic 程式使用：HACK、TODO、UNDONE 和 UnresolvedMergeConflict。 這些權杖標籤不區分大小寫。

Visual Studio 會在包含三個元件時辨識註解：

• 註解標記，例如 //、#、<!--

• 註解權杖前置詞，例如 TODO、hack、MoveToHeader

• 權杖後面的註解文字

以下是 C# 中的程式碼註解範例：

// TODO: Load state from previously suspended application

當 Visual Studio 辨識預先定義的權杖時，它會在 [工作清單] 中將註解文字顯示為工作。

建立自訂權杖

您可以遵循下列步驟，為任何程式設計語言建立自訂權杖：

1. 在 Visual Studio [工具] 功能表中，選取 [選項]。

2. 展開 [環境] 區段，然後選取 [ 工作清單] 索引標籤 。[工作清單選項] 頁面開啟：

   

3. 在 [名稱] 文字方塊中，輸入自訂權杖名稱，例如 [Optimize]。

4. 展開 [優先順序] 下拉式清單，然後選取自訂權杖的預設優先順序。

5. 若要將自訂權杖新增至權杖清單，請選取 [新增]。

6. 選取 [確定] 以套用變更。

當 Visual Studio 辨識自訂權杖時，它會在 [工作清單] 中將註解文字顯示為工作。

新增程序碼工作捷徑

程式碼工作捷徑是您在 Visual Studio [工作清單] 中追蹤的程式碼中新增的書籤。 這種類型捷徑的圖示與一般書籤的不同。

1. 若要建立程式碼工作捷徑，請將指標插入要放置捷徑的程式碼。

2. 選取 [編輯]>[書籤]>[新增工作列表捷徑]，或使用鍵盤捷徑 [Ctrl]]+[K]、[Ctrl]+[H]。

   

使用工作和捷徑來存取程序式碼

Visual Studio 使用程式碼註解權杖執行個體和程式碼工作捷徑更新 [工作清單] 之後，您可以使用這些項目快速移至程式碼中的連結位置：

1. 若要前往任何工作程式碼中的位置，請按兩下 [工作清單] 中的工作項目。

2. 若要跳至清單中上一個或下一個工作的程序碼位置，請以滑鼠右鍵按一下清單中的目前工作，然後選取 [下一個工作] 或 [上一個工作]。 這些動作也可以在 Visual Studio [檢視] 功能表上取得。

排序清單項目

您可以變更清單項目的排序順序：

1. 若要變更清單的排序順序，請選取一資料行標頭。 Visual Studio 會根據選取資料行中的項目來排序清單內容。

2. 若要套用次要排序順序，請選取 [Shift] 和不同的資料行標頭。 Visual Studio 會依第一個選取的資料行排序清單內容，後面接著第二個選取的資料行。

您可以繼續此方法，並選取 [Shift] 和另一個資料行標頭，以套用更精簡的排序。

顯示、隱藏和排序資料行

您也可以使用清單中的特定資料行：

1. 若要顯示資料行，請以滑鼠右鍵按一下清單上的任何位置，然後選取 [顯示資料行]。 在彈出式視窗功能表上，選取要顯示的資料行。 可使用下列資料行：[優先順序]、[說明]、[專案]、[專案排名]、[路徑]、[檔案]、[行]，和 [資料行]。

   • 在彈出式視窗功能表上，Visual Studio 會顯示可見資料行旁的核取記號。

   • 若要隱藏資料行，請取消選取彈出式視窗功能表上的資料行名稱。 Visual Studio 會移除核取記號。

2. 若要變更清單中資料行的排序，請將資料行標頭拖曳至所需的位置。

提示

[專案排名] 資料行代表專案相依性。 排名為 1 的專案不相依於任何其他專案。 排名為 2 的專案取決於排名為 1 的一個或多個專案，於此類推。 如需詳細資訊，請參閱 標準資料表資料行定義: 專案排名欄位。

相關內容

• 檢閱 [工作清單、環境和選項對話方塊] 的參考