通过

MarkupCompilePass2 任务

  • 项目

MarkupCompilePass2 任务对引用同一项目中的类型的 XAML 文件执行第二轮标记编译。

任务参数

参数 说明
AlwaysCompileMarkupFilesInSeparateDomain 可选 Boolean 参数。

指定是否在单独的 AppDomain 下运行该任务。 如果此参数返回 false，则任务将在与 MSBuild 相同的 AppDomain 中运行，且运行速度更快。 如果该参数返回 true，则任务将在独立于 MSBuild 的另一个 AppDomain 中运行，且运行速度更慢。
AssembliesGeneratedDuringBuild 可选 String [] 参数。

指定在生成过程中对更改的程序集的引用。 例如，Visual Studio 解决方案可能包含一个引用了另一个项目的已编译输出的项目。 在这种情况下，可以将第二个项目的已编译输出添加到 AssembliesGeneratedDuringBuild。

注意：AssembliesGeneratedDuringBuild 必须包含对生成解决方案所生成的一组完整程序集的引用。
AssemblyName 必需的 String 参数。

指定为项目生成的程序集的简称。 例如，如果项目生成一个名为 WinExeAssembly.exe 的可执行文件，则 AssemblyName 参数的值为 WinExeAssembly 。
GeneratedBaml 可选的 ITaskItem[] 输出参数。

包含已生成的 XAML 二进制格式文件的列表。
KnownReferencePaths 可选 String [] 参数。

指定在生成过程中对从未更改的程序集的引用。 包括位于全局程序集缓存 (GAC)、.NET 安装目录等位置中的程序集。
Language 必需的 String 参数。

指定编译器支持的托管语言。 有效的选项有 C#、VB、JScript 和 C++。
LocalizationDirectivesToLocFile 可选 String 参数。

指定如何针对每个源 XAML 文件生成本地化信息。 有效选项有“无”、“仅注释”和“全部”。
OutputPath 必需的 String 参数。

指定在其中生成 XAML 二进制格式文件的目录。
OutputType 必需的 String 参数。

指定项目生成的程序集的类型。 有效选项有 winexe、exe、library 和 netmodule。
References 可选的 ITaskItem[] 参数。

指定引用列表，范围从文件到程序集，它们包含 XAML 文件中所使用的类型。 一个引用针对的是 GenerateTemporaryTargetAssembly 任务生成的程序集，该任务必须在 MarkupCompilePass2 任务之前运行。
RootNamespace 可选 String 参数。

指定项目内部的类的根命名空间。 当对应的 XAML 文件不包括 x:Class 属性时，RootNamespace 也将用作生成的托管代码文件的默认命名空间。
XAMLDebuggingInformation 可选 Boolean 参数。

如果为 true，则会生成诊断信息并将其包括在编译的 XAML 中，以辅助调试。

注解

运行 MarkupCompilePass2 之前，必须先生成包含 XAML 文件（该文件的标记编译轮有延迟）所使用的类型的临时程序集。 通过运行 GenerateTemporaryTargetAssembly 任务生成临时程序集。

对生成的临时程序集的引用将在运行时提供给 MarkupCompilePass2，使得在第一轮标记编译过程中编译存在延迟的 XAML 文件现可编译为二进制格式。

示例

下面的示例演示如何使用 MarkupCompilePass2 任务来执行第二轮编译。

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <UsingTask
    TaskName="Microsoft.Build.Tasks.Windows.MarkupCompilePass2"
    AssemblyFile="C:\Program Files\Reference Assemblies\Microsoft\Framework\v3.0\PresentationBuildTasks.dll" />
  <Target Name="MarkupCompilePass2Task">
    <MarkupCompilePass2
      AssemblyName="WPFMSBuildSample"
      Language="C#"
      OutputType="WinExe"
      OutputPath="obj\Debug\"
      References=".\obj\debug\WPFMSBuildSample.exe;c:\windows\Microsoft.net\Framework\v2.0.50727\System.dll;C:\Program Files\Reference Assemblies\Microsoft\WinFx\v3.0\PresentationCore.dll;C:\Program Files\Reference Assemblies\Microsoft\WinFx\v3.0\PresentationFramework.dll;C:\Program Files\Reference Assemblies\Microsoft\WinFx\v3.0\WindowsBase.dll" />
  </Target>
</Project>

请参阅