MSBuild 任务参考

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

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

参数	说明
Condition	可选 String 参数。 MSBuild 引擎使用 Boolean 表达式来确定是否执行此任务。 有关 MSBuild 支持的条件的信息，请参阅条件。
ContinueOnError	可选参数。 可以包含下列值之一： - WarnAndContinue 或 true。 当任务失败时，Target 元素中的后续任务和生成将继续执行，并且来自该任务的所有错误都被视为警告。 - ErrorAndContinue。 当任务失败时，Target 元素中的后续任务和生成将继续执行，并且来自该任务的所有错误都被视为错误。 - ErrorAndStop 或 false（默认值）。 当任务失败时，将不会执行 Target 元素中的剩余任务和生成，并且整个 Target 元素和生成都被视为已失败。 4.5 之前的 .NET Framework 版本仅支持 true 和 false 值。 有关详细信息，请参阅如何：忽略任务中的错误。

在本节中

• 任务基类

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

• TaskExtension 基类

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

• ToolTaskExtension 基类

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

• AL（程序集链接器）任务

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

• AspNetCompiler 任务

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

• AssignCulture 任务

为项分配区域性标识符。

• AssignProjectConfiguration 任务

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

• AssignTargetPath 任务

接受文件列表，并添加 <TargetPath> 属性（如果尚未指定）。

• CallTarget 任务

调用项目文件中的目标。

• CombinePath 任务

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

• ConvertToAbsolutePath 任务

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

• Copy 任务

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

• CreateCSharpManifestResourceName 任务

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

• CreateItem 任务

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

• CreateProperty 任务

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

• CreateVisualBasicManifestResourceName 任务

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

• Csc 任务

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

• Delete 任务

删除指定的文件。

• DownloadFile 任务

将文件下载到指定位置。

• Error 任务

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

• Exec 任务

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

• FindAppConfigFile 任务

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

• FindInList 任务

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

• FindUnderPath 任务

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

• FormatUrl 任务

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

• FormatVersion 任务

将修订号追加到版本号。

• GenerateApplicationManifest 任务

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

• GenerateBootstrapper 任务

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

• GenerateDeploymentManifest 任务

生成 ClickOnce 部署清单。

• GenerateResource 任务

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

• GenerateTrustInfo 任务

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

• GetAssemblyIdentity 任务

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

• GetFileHash 任务

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

• GetFrameworkPath 任务

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

• GetFrameworkSdkPath 任务

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

• GetReferenceAssemblyPaths 任务

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

• LC 任务

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

• MakeDir 任务

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

• Message 任务

在生成期间记录消息。

• Move 任务

将文件移至新位置。

• MSBuild 任务

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

• ReadLinesFromFile 任务

从文本文件读取项列表。

• RegisterAssembly 任务

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

• RemoveDir 任务

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

• RemoveDuplicates 任务

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

• RequiresFramework35SP1Assembly 任务

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

• ResGen 任务

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

• ResolveAssemblyReference 任务

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

• ResolveComReference 任务

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

• ResolveKeySource 任务

确定强名称密钥源

• ResolveManifestFiles 任务

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

• ResolveNativeReference 任务

解析本机引用。

• ResolveNonMSBuildProjectOutput 任务

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

• SGen 任务

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

• SignFile 任务

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

• Touch 任务

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

• UnregisterAssembly 任务

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

• Unzip 任务

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

• UpdateManifest 任务

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

• Vbc 任务

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

• VerifyFileHash 任务

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

• Warning 任务

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

• WriteCodeFragment 任务

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

• WriteLinesToFile 任务

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

• XmlPeek 任务

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

• XmlPoke 任务

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

• XslTransformation 任务

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

• ZipDirectory 任务

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

请参阅

• MSBuild 参考
• 任务写入
• 任务