更新：2007 年 11 月
Label 工作會將標籤 (Label) 附加至工作區中最新的檔案版本。
參數
參數 |
描述 |
|---|---|
Workspace |
指定工作區名稱。 |
Name |
指定標籤名稱。根據預設，Team Foundation Build 建立的標籤名稱和 BuildNumber 屬性相同。 覆寫 TFSBuild.proj 檔內的 LabelName 屬性，即可指定不同的標籤名稱。 |
Version |
指定檔案或資料夾的版本。 根據預設，Team Foundation Build 會標示由 WorkspaceName 屬性指定之工作區的完整內容。 覆寫 LabelVersion 屬性，即可指定不同的 versionspec。這對應至 tf.exe label 命令的 versionspec 參數。如需詳細資訊，請參閱 Label 命令 (Team Foundation 版本控制)。 |
Files |
指定要加上標籤的項目。 根據預設，Team Foundation Build 會取代在其標籤內已存在之項目的版本。這對應至 tf.exe label 命令之 /child 選項的 replace 之值。 將 TFSBuild.proj 檔案中的 LabelFiles 屬性設定為 merge，即不會變更現有標籤內的項目。 |
Child |
根據預設，Team Foundation Build 會取代在其標籤內已存在之項目的版本。 將 TFSBuild.proj 檔案中的 LabelChild 屬性設定為 merge，即不會變更現有標籤內的項目。 這對應於tf.exe label 中 /child 選項。 |
Comments |
指定 Team Foundation Build 用於標籤的註解。 Team Foundation Build 建立的預設註解為「Team Build 建立的標籤」。 覆寫 TFSBuild.proj 檔中的 LabelComment 屬性，即可指定不同的註解。 |
Recursive |
指定檔案是否以遞迴方式加上標籤。這對應至 tf.exe label 命令的 /recursive 選項。 將 TFSBuild.proj 檔中的 LabelRecursive 屬性設定為 false，只對最上層的項目加上標籤。 |
備註
Label 工作定義於 Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll 中。Microsoft.TeamFoundation.Build.targets 檔包含 Label 工作的執行個體 (Instance)，而且 Team Foundation Build 會將它當做 CoreLabel 目標的預設實作 (Implementation) 使用。
Team Foundation Build 電腦上的 <root>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild 資料夾包含 Microsoft.TeamFoundation.Build.targets 檔。
範例
下列範例會顯示在 Microsoft.TeamFoundation.Build.targets 檔中定義之 Label 工作的預設執行個體。
<Label
Workspace="$(WorkspaceName)"
Name="$(LabelName)$(LabelScope)"
Version="$(LabelVersion)"
Files="$(LabelFiles)"
Child="$(LabelChild)"
Comments="$(LabelComment)"
Recursive="$(LabelRecursive)" />
請參閱
工作
概念
參考
Label 命令 (Team Foundation 版本控制)