使用標籤來建立檔案的快照

標籤可讓您建立檔案的快照，以便於日後參考到該快照。 透過使用標籤，您可以檢視、建置或甚至將大量檔案復原至套用標籤時的狀態。

必要的使用權限

若要套用標籤，您必須將 [標籤] 權限設定為 [允許]。 若要尋找、列出或檢視標籤，您必須將 [讀取] 權限設定為 [允許]。 若要修改或刪除標籤，您必須擁有該標籤或將 [管理標籤] 權限設定為 [允許]。

本文內容

• 使用標籤

• 套用標籤

• 重新命名標籤

• 列出、尋找、檢視、編輯和移除標籤

• 將檔案的標籤版本下載到工作區

• 使用標籤視窗處理標籤

• 將檔案復原為先前標籤過的版本

• 從命令列使用標籤

使用標籤

在許多軟體專案中，當程式碼已達到合理的品質等級和穩定度時，專案小組便會建置並發行產品的新版本。 專案小組必須標記每個檔案目前的版本，因此即使檔案繼續變更，專案小組仍然可以取得並建置其專案中每個檔案的新版本。

理論上，您可以手動記錄每個檔案的每個變更集 ID，但這種程序顯然不切實際。 Team Foundation 版本控制簡化了這項工作：您可將標籤套用到包含檔案的資料夾、分支或 Team 專案。 您可以依個人偏好，使用任何一種命名慣例為標籤命名。 標籤名稱的範例包括："Sprint 5"、"M1"、"Beta2" 和 "Release Candidate 0"。

套用標籤之後，您可以使用標籤來限定作業，例如建置、分支、合併、比較和取得特定版本的檔案或資料夾。

有時候您會在套用標籤後才決定要變更標籤。 Team Foundation 版本控制可讓您將標籤套用到其他檔案、從特定檔案移除標籤，甚至是修改套用標籤的特定檔案版本。

秘訣
套用標籤提供了許多與建立分支相同的優點，但是通常成本較低且比較不複雜。

套用標籤

套用標籤

1. 在 [原始檔控制總管] 中，以滑鼠右鍵按一下要套用標籤的集合、Team 專案、分支、資料夾或檔案，然後按一下 [套用標籤]。

   [新增標籤] 對話方塊隨即出現。

2. 在 [名稱] 方塊中，輸入標籤的名稱。

3. (選用) 在 [註解] 方塊中輸入您的註解。

4. 在 [版本] 清單中，預設會選取 [最新的版本]。 這個選項是最常用的選項，但是如果您需要讓標籤以特定的版本做為目標，可以選取下列其中一個選項：

   • 如果按一下 [變更集]，您就可以在 [變更集] 方塊內指定變更集的編號。 或者，按一下省略符號 (…) 開啟 [尋找變更集] 對話方塊。 如需詳細資訊，請參閱 尋找變更集的相關資訊。

   • 如果按一下 [日期]，您就可以在 [日期] 方塊內指定日期，或在下拉式功能表上從日曆選取一個日期。

   • 如果按一下 [標籤]，您就可以指定現有的標籤，做為新標籤的依據。 在 [標籤] 方塊中輸入標籤名稱，或按一下省略符號 (…) 開啟 [尋找標籤] 對話方塊。 如需詳細資訊，請參閱尋找、編輯和移除標籤。

   • 如果按一下 [工作區版本]，便會為工作區內的版本建立標籤。

5. 當您對設定感到滿意時，請執行下列其中一個步驟：

   • 若要套用標籤，請按一下 [建立]。

   • 若要套用標籤，然後在套用完成後進行修改，請按一下 [建立並編輯]。 這會套用標籤，然後顯示 [標籤] 視窗。 如需使用 [標籤] 視窗編輯標籤的詳細資訊，請參閱使用標籤視窗處理標籤。

注意事項
當您使用已經存在的名稱套用標籤時，系統會發出警告並詢問您是否要繼續。 如果您按一下 [確定] 繼續作業，任何未包含在要套用標籤之路徑中的項目，都將不再具有該標籤。

重新命名標籤

雖然您不能修改現有標籤的名稱，但是可以輕易地將新標籤套用到與其他標籤套用目標完全相同的檔案和相同的版本。

根據現有標籤套用標籤

1. 在 [原始檔控制總管] 中，以滑鼠右鍵按一下專案集合節點 (根節點)，然後按一下 [套用標籤]。

   [新增標籤] 對話方塊隨即出現。

2. 在 [名稱] 方塊中，輸入標籤的名稱。

3. (選用) 在 [註解] 方塊中輸入註解。

4. 在 [版本] 清單中，選取 [標籤]。

   [標籤] 方塊隨即出現。

5. 請執行下列其中一個步驟：

   • 輸入現有標籤的名稱。

   • 如果您不確定現有標籤的名稱，請按一下 [標籤] 方塊旁，具有省略符號 (…) 的瀏覽按鈕。

     [尋找標籤] 對話方塊隨即出現。

     使用 [尋找標籤] 對話方塊中的選項來篩選標籤清單，並尋找要套用新標籤的現有標籤 (如需詳細資訊，請參閱尋找、編輯和移除標籤)。

6. 按一下 [建立]。

7. (選用) 建立新標籤之後，您可以移除舊標籤。 如需詳細資訊，請參閱尋找、編輯和移除標籤。

列出、尋找、檢視、編輯和移除標籤

列出及尋找標籤的途徑有兩個：一個是 [尋找標籤] 對話方塊，另一個是 [記錄] 視窗中的 [標籤] 索引標籤。 在您找到所需的標籤之後，便可檢視、編輯、移除該標籤，或是使用套用該標籤的檔案。

使用尋找標籤對話方塊尋找及使用標籤

1. 在 [原始檔控制總管] 的 [檔案] 功能表上，指向 [原始檔控制]，再指向 [標籤]，然後按一下 [尋找標籤]。

   [尋找標籤] 對話方塊隨即出現。

2. (選用) 執行下列一個或多個步驟，限定您的搜尋範圍：

   • 在 [名稱] 文字方塊中，輸入標籤的名稱。

   • 在 [專案] 清單中，選取包含您要尋找之標籤的 Team 專案。

   • 在 [擁有者] 文字方塊中，輸入標籤擁有者的名稱或別名。

3. 按一下 [尋找]。

   [結果] 清單隨即顯示符合所輸入搜尋準則的標籤。

4. (選用) 請執行下列其中一個步驟：

   • 若要檢視或編輯標籤，請選取標籤，然後按一下 [編輯]。

     [標籤] 視窗隨即出現。 如需詳細資訊，請參閱使用標籤視窗處理標籤。

   • 若要刪除標籤，請選取標籤，然後按一下 [刪除]。

   • 按一下 [關閉]。

有時候，您可能不確定標籤的名稱，但是知道標籤已套用到受到版本控制的特定項目。 下列程序說明如何在這種情況下尋找標籤並使用標籤。

列出並使用套用到特定項目的標籤

1. 在 [原始檔控制總管] 中，以滑鼠右鍵按一下已套用您想尋找之標籤的項目，然後按一下 [檢視記錄]。

   [記錄] 視窗隨即出現。

2. 按一下 [標籤] 索引標籤，顯示套用至此項目的標籤清單。

3. (選擇性) 請執行下列其中一個步驟：

   • 若要檢視或編輯標籤，請以滑鼠右鍵按一下標籤，然後選取 [編輯標籤]。

     [標籤] 視窗隨即出現。 如需如何使用此視窗的詳細資訊，請參閱使用標籤視窗處理標籤。

   • 若要刪除標籤，請以滑鼠右鍵按一下標籤，然後選取 [刪除標籤]。

   • 以滑鼠右鍵按一下標籤，並選取其他動作，例如 [取得這個版本] 和 [比較]。

如需如何使用 [記錄] 視窗中 [標籤] 索引標籤的詳細資訊，請參閱 檢視歷程資料。

將檔案的標籤版本下載到工作區

將一組檔案加上標籤的程序就像是建立這些檔案在特定時間點的快照一樣。 在建立這個快照的幾週或幾個月後，您可能需要檢視或使用存在該快照中的檔案。 下列程序說明如何將一組檔案的標籤版本下載到工作區中。

將檔案的標籤版本下載到工作區

1. 在 [原始檔控制總管] 中，以滑鼠右鍵按一下包含要下載之項目的專案集合、Team 專案、分支或資料夾，然後按一下 [取得特定版本]。

   [取得] 對話方塊隨即出現。

2. 從 [類型] 清單選取 [標籤]，然後在 [標籤] 方塊中輸入標籤名稱，或按一下省略符號 (…) 開啟 [尋找標籤] 對話方塊。 如需如何使用此對話方塊的詳細資訊，請參閱尋找、編輯和移除標籤。

3. 檢閱並視情況選取 [取得] 對話方塊中的其他選項。

4. 按一下 [取得]。

使用標籤視窗處理標籤

使用上述其中一個程序開啟 [標籤] 視窗之後，您就可以準備開始處理標籤。 視窗頂端有一個顯示註解的方塊，您可以視需要編輯此註解。

您可以使用 [標籤] 視窗執行下列工作：

• 將項目加入至標籤

• 從標籤移除項目

• 變更檔案的版本

• 在項目上執行其他動作

將項目加入至標籤

1. 在 [標籤] 視窗中按一下 [加入項目]。

   [選擇項目版本] 對話方塊隨即出現。

2. 在 [選擇項目版本] 對話方塊中，巡覽並選取您要加入的項目。

   秘訣
   您可以按住 CONTROL 或 SHIFT 鍵，然後選取多個項目。

3. (選用) 如果您需要讓標籤以特定的版本做為目標，可以從 [版本] 清單中選取下列其中一個選項：

   • 如果按一下 [最新的版本]，標籤便會套用到版本控制中最新的版本。

   • 如果按一下 [變更集]，您就可以在 [變更集] 方塊內指定變更集的編號。 或者，按一下省略符號 (…) 開啟 [尋找變更集] 對話方塊。 如需詳細資訊，請參閱 尋找變更集的相關資訊。

   • 如果按一下 [日期]，您就可以在 [日期] 方塊內指定日期，或在下拉式功能表上從日曆選取一個日期。

   • 如果按一下 [標籤]，您就可以指定現有的標籤，做為新標籤的依據。 在 [標籤] 方塊中輸入標籤名稱，或按一下省略符號 (…) 開啟 [尋找標籤] 對話方塊。 如需詳細資訊，請參閱尋找、編輯和移除標籤。

   • 如果按一下 [工作區版本]，便會為工作區內的版本建立標籤。

4. 按一下 [確定]。

5. 按一下 [檔案] 功能表，然後按一下 [儲存]。

從標籤移除項目

1. 在 [標籤] 視窗中，找出您要從這個標籤移除的集合、Team 專案、分支、資料夾或檔案。

2. 以滑鼠右鍵按一下項目，並選取 [從標籤移除]。

   標籤隨即從項目中移除。 如果項目是專案集合、Team 專案、分支或資料夾，則標籤也會從其內含的所有項目移除。

3. 按一下 [檔案] 功能表，然後按一下 [儲存]。

變更檔案的版本

1. 在 [標籤] 視窗中，找出您要修改的檔案。

2. 以滑鼠右鍵按一下檔案，並選取 [變更項目版本]。

3. [選擇項目版本] 對話方塊隨即出現。

4. 請執行下列其中一個步驟：

   • 按一下 [最新的版本]，將標籤套用到版本控制中最新的版本。

   • 按一下 [變更集]，然後在 [變更集] 方塊內指定變更集的編號。 或者，按一下省略符號 (…) 開啟 [尋找變更集] 對話方塊。 如需詳細資訊，請參閱 尋找變更集的相關資訊。

   • 按一下 [日期]，然後在 [日期] 方塊內指定日期，或在下拉式功能表上從日曆選取一個日期。

   • 按一下 [標籤]，然後指定現有的標籤，做為新標籤的依據。 在 [標籤] 方塊中輸入標籤名稱，或按一下省略符號 (…) 開啟 [尋找標籤] 對話方塊。 如需詳細資訊，請參閱尋找、編輯和移除標籤。

   • 按一下 [工作區版本]，為工作區內的版本建立標籤。

5. 按一下 [檔案] 功能表，然後按一下 [儲存]。

在標籤項目上執行其他動作

當您在 [標籤] 視窗的項目上按一下滑鼠右鍵時，也可以選取下列其中一個命令：

• 檢視 (僅限檔案)

• 檢視記錄

• 比較 (僅限檔案)

• 附註 (僅限檔案)

• 取得這個版本

將檔案復原為標籤版本

您可以使用 tf rollback 命令，將一組檔案還原成由標籤所標記之版本中的狀態。 如需詳細資訊，請參閱 Rollback 命令 (Team Foundation 版本控制)。

從命令列使用標籤

本節提供幾個從命令列使用標籤的一般方式。

從命令列列出標籤

從命令列列出標籤

1. 依序按一下 [開始]、[所有程式]，並依序指向 [Microsoft Visual Studio 2010]、[Visual Studio Tools]，然後按一下 [Visual Studio 命令提示字元 (2010)]。

2. 輸入 cd path，其中 path 是含有適用工作區的目錄。

3. 輸入 tf labels。

從命令列套用及編輯標籤

從命令列套用標籤的效果與使用 Visual Studio ALM 套用標籤 (如本主題前面所述) 不同。 當您使用 Visual Studio ALM 套用已經存在的標籤時，這項作業會從所有的檔案版本移除標籤，然後再套用標籤。

不過，從命令列進行的標籤作業具有累積的特性。 例如，假設您將 mylabel 標籤套用到 $/DinnerNow/Features/FeatureTeamA。 如果您稍後又將 mylabel 標籤套用到 $/DinnerNow/Features/FeatureTeamB，mylabel 將同時套用到這兩個資料夾。

若要從命令列套用標籤

1. 依序按一下 [開始]、[所有程式]，並依序指向 [Microsoft Visual Studio 2010]、[Visual Studio Tools]，然後按一下 [Visual Studio 命令提示字元 (2010)]。

2. 輸入 cd path，其中 path 是您要加上標籤的資料夾路徑。

3. 輸入 tf label mylabel . /recursive。

   系統會將 mylabel 標籤套用到 "path" 資料夾的工作區版本以及其包含的所有檔案與資料夾。

從命令列移除標籤

若要從命令列移除標籤

1. 依序按一下 [開始]、[所有程式]，並依序指向 [Microsoft Visual Studio 2010]、[Visual Studio Tools]，然後按一下 [Visual Studio 命令提示字元 (2010)]。

2. 輸入 cd path，其中 path 是含有適用工作區的目錄。

3. 輸入 tf label /deletelabel name，其中 label name 是您想要刪除之標籤的名稱。

請參閱

參考

Label 命令 (Team Foundation 版本控制)

Labels 命令

概念

使用變更集

建立工作區以使用 Team 專案

Team Foundation Server 使用權限

使用原始檔控制總管

其他資源

分支及合併