标签任务

项目
08/18/2008

更新：2007 年 11 月

Label 任务向工作区中文件的最新版本附加一个标签。

参数

参数	说明
Workspace	指定工作区名称。
Name	指定标签名称。默认情况下，Team Foundation Build 创建的标签名称与 BuildNumber 属性的名称相同。若要指定另一个标签名称，请重写 TFSBuild.proj 文件中的 LabelName 属性。
Version	指定文件或文件夹的版本。默认情况下，Team Foundation Build 标记由 WorkspaceName 属性指定的工作区中的所有内容。若要指定另一个 versionspec，请重写 LabelVersion 属性。这对应于 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 任务的一个实例，Team Foundation Build 使用该实例作为 CoreLabel 目标的默认实现。

Team Foundation Build 计算机上的 <根>:\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)" />

请参见

通过

标签任务

参数

备注

示例

请参见

任务

概念

参考

其他资源

其他资源