MSBuild 任务参考

任务提供在生成过程中运行的代码。 MSBuild 提供以下列表中的任务。 安装 C++ 工作负载时,可使用其他任务来生成 C++ 项目。 有关详细信息,请参阅 C++ 任务

除了此部分各主题中列出的参数外,每项任务还有下列参数:

参数 说明
Condition 可选 String 参数。

MSBuild 引擎使用 Boolean 表达式来确定是否执行此任务。 有关 MSBuild 支持的条件的信息,请参阅条件
ContinueOnError 可选参数。 可以包含下列值之一:

- WarnAndContinuetrue。 当任务失败时,Target 元素中的后续任务和生成将继续执行,并且来自该任务的所有错误都被视为警告。
- ErrorAndContinue。 当任务失败时,Target 元素中的后续任务和生成将继续执行,并且来自该任务的所有错误都被视为错误。
- ErrorAndStopfalse(默认值)。 当任务失败时,将不会执行 Target 元素中的剩余任务和生成,并且整个 Target 元素和生成都被视为已失败。

4.5 之前的 .NET Framework 版本仅支持 truefalse 值。

有关详细信息,请参阅如何:忽略任务中的错误

在本节中

向派生自 Task 类的任务添加几个参数。 请不要直接使用。

向派生自 TaskExtension 类的任务添加几个参数。 请不要直接使用。

向派生自 ToolTaskExtension 类的任务添加几个参数。 请不要直接使用。

从一个或多个文件(可以是模块,也可以是资源文件)创建一个具有清单的程序集。

包装 aspnet_compiler.exe,它是预编译 ASP.NET 应用程序的实用工具。

为项分配区域性标识符。

接受配置字符串列表,并将其分配给指定的项目。

接受文件列表,并添加 <TargetPath> 属性(如果尚未指定)。

调用项目文件中的目标。

将指定路径合并到单个路径。

将相对路径或引用转换为绝对路径。

将文件复制到一个新位置。

根据给定的 .resx 文件名或其他资源创建 C# 样式的清单名称。

填充输入项中的项集合,允许从一个列表向另一个列表复制项。

填充输入值中的属性,允许从一个属性或字符串向另一个属性或字符串复制值。

根据给定的 .resx 文件名或其他资源创建 Visual Basic 样式的清单名称。

调用 Visual C# 编译器以生成可执行文件、动态链接库或代码模块。

删除指定的文件。

将文件下载到指定位置。

基于评估的条件语句,停止生成操作并记录错误。

使用指定参数运行指定程序或命令。

在提供的列表中查找 app.config 文件(若有)。

在指定的列表中查找具有匹配的 itemspec 的项。

确定指定项集合中的哪些项存在于指定的文件夹及其所有子文件夹中。

将 URL 转换为正确的 URL 格式。

将修订号追加到版本号。

生成 ClickOnce 应用程序清单或本机清单。

提供自动化方式来检测、下载和安装应用程序及其必备组件。

生成 ClickOnce 部署清单。

将 .txt 和 .resx 文件转换为公共语言运行时二进制 .resources 文件。

从基本清单以及从 TargetZoneExcludedPermissions 属性生成应用程序信任。

从指定的文件检索程序集标识并输出标识信息。

计算文件或文件集的内容的校验和。

检索 .NET Framework 程序集的路径。

检索 Windows 软件开发工具包 (SDK) 的路径。

返回各种框架的引用程序集路径。

从 .licx 文件生成 .license 文件。

创建目录,并在必要时创建任何父目录。

在生成期间记录消息。

将文件移至新位置。

从其他 MSBuild 项目生成 MSBuild 项目。

从文本文件读取项列表。

读取指定程序集中的元数据,并在注册表中添加必要的项。

删除指定的目录及其所有文件和子目录。

从指定的项集合中删除重复的项。

确定应用程序是否需要 .NET Framework 3.5 SP1。

  • ResGen 任务

已过时。 使用 GenerateResource 任务可以将 .txt 和 .resx 文件转换成公共语言运行时二进制 .resources 文件,反之亦然。

确定依赖指定程序集的所有程序集。

获取一个或多个类型库名称或 .tlb 文件的列表,将这些类型库解析为磁盘上的位置。

确定强名称密钥源

在生成过程中,将以下各项解析为文件以便生成清单:生成项、依赖项、附属项、内容、调试符号和文档。

解析本机引用。

确定非 MSBuild 项目引用的输出文件。

创建指定程序集中的类型的 XML 序列化程序集。

使用指定证书签署指定文件。

设置文件的访问和修改时间。

注销用于 COM 互操作的指定程序集。

将 .zip 存档解压缩到指定位置。

更新清单中所选的属性并重新签名。

调用 Visual Basic 编译器以生成可执行文件、动态链接库或代码模块。

验证文件是否与预期的文件哈希匹配。

基于评估的条件语句,在生成期间记录警告。

使用指定的生成代码片段,生成临时代码文件。 不会删除该文件。

将指定项写入指定的文本文件。

从 XML 文件返回 XPath 查询指定的值。

将 XPath 查询指定的值设置为 XML 文件。

使用可扩展样式表语言转换 (XSLT) 或编译的 XSLT 转换 XML 输入,并将其输出到一台输出设备或一个文件。

根据目录内容创建 .zip 存档。

请参阅