MSBuild 任务参考

这些任务提供在生成过程中运行的代码。 MSBuild 提供以下列表中的任务。 安装 Visual C++时，可使用其他任务来生成 Visual C++项目。 有关更多信息，请参见特定于 Visual C++ 的 MSBuild 任务。

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

Parameter	描述
Condition	可选 String 参数。 MSBuild 引擎用来确定是否执行此任务的 Boolean 表达式。 有关 MSBuild 支持的条件的信息，请参见 MSBuild 条件。
ContinueOnError	可选参数。 可以包含下列值之一： WarnAndContinue 或 真。 当任务失败时，在 目标 元素和生成的后续任务继续执行，因此，从任务的所有错误视为警告。 ErrorAndContinue。 当任务失败时，在 Target 元素和生成的后续任务继续执行，因此，从任务的所有错误视为错误。 ErrorAndStop 或 假 (默认值)。 当任务失败时，在 Target 元素和生成的余下的任务，不会执行，整个 Target 元素和编译考虑失败。 .NET Framework 的版本在 4.5 版之前的仅支持 true 和 false 值。 有关更多信息，请参见如何：忽略任务中的错误。

本节内容

• 任务基类
  向派生自 Task 类的任务添加一些参数。

• TaskExtension 基类
  向派生自 TaskExtension 类的任务添加一些参数。

• ToolTaskExtension 基类
  向派生自 ToolTaskExtension 类的任务添加一些参数。

• AL（程序集链接器）任务
  从一个或多个文件（可以是模块，也可以是资源文件）生成一个具有清单的程序集。

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

• AssignCulture 任务
  为项分配区域性标识符。

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

• AssignTargetPath 任务
  接受文件的列表，并添加 <TargetPath> 特性（如果尚未指定）。

• CallTarget 任务
  调用项目文件中的目标。

• CombinePath 任务
  将多个指定的路径组合为单个路径。

• ConvertToAbsolutePath 任务
  将相对路径或引用转换为绝对路径。

• Copy 任务
  将文件复制到新的位置。

• CreateCSharpManifestResourceName 任务
  基于给定的 .resx 文件名或其他资源创建 Visual C# 样式的清单名称。

• CreateItem 任务
  使用输入项填充项集合，允许从一个列表向另一个列表复制项。

• CreateProperty 任务
  使用输入值填充属性，允许从一个属性或字符串向另一个属性或字符串复制值。

• CreateVisualBasicManifestResourceName 任务
  基于给定的 .resx 文件名或其他资源创建 Visual Basic 样式的清单名称。

• Csc 任务
  调用 Visual C# 编译器以执行可执行程序、动态链接库文件或代码模块。

• Delete 任务
  删除指定的文件。

• Error 任务
  根据计算的条件语句停止生成操作并记录错误。

• Exec 任务
  运行带有指定参数的指定程序或命令。

• FindAppConfigFile 任务
  在提供的列表中查找 app.config 文件（如果有任何此类文件）。

• FindInList 任务
  在指定的列表中查找具有匹配的项规范的项。

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

• FormatUrl 任务
  将 URL 转换为正确的 URL 格式。

• FormatVersion 任务
  将修订版本号附加到版本号上。

• GenerateApplicationManifest 任务
  生成 ClickOnce 应用程序清单或本机清单。

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

• GenerateDeploymentManifest 任务
  生成 ClickOnce 部署清单。

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

• GenerateTrustInfo 任务
  根据基础清单以及 TargetZone 和 ExcludedPermissions 参数生成应用程序信任。

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

• 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 互操作 的指定程序集。

• UpdateManifest 任务
  更新清单中的所选属性并重新签名。

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

• Warning 任务
  根据计算的条件语句在生成期间记录警告。

• WriteCodeFragment 任务
  使用指定的生成代码片段，生成一个临时代码文件。 不会删除该文件。

• WriteLinesToFile 任务
  将指定项写入指定的文本文件。

• XmlPeek 任务
  从 XML 文件返回 XPath 查询指定的值。

• XmlPoke 任务
  将 XPath 查询指定的值设置为 XML 文件。

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

请参见

概念

任务写入

MSBuild 任务

其他资源

MSBuild 参考