MarkupCompilePass2 Task
The MarkupCompilePass2 task performs second-pass markup compilation on Extensible Application Markup Language (XAML) files that reference types in the same project.
Task Parameters
Parameter |
Description |
|---|---|
AlwaysCompileMarkupFilesInSeparateDomain |
Optional Boolean parameter. Specifies whether to run the task in a separate AppDomain. If this parameter returns false, the task runs in the same AppDomain as Microsoft build engine (MSBuild), and it runs faster. If the parameter returns true, the task runs in a second AppDomain that is isolated from MSBuild and runs slower. |
AssembliesGeneratedDuringBuild |
Optional String[] parameter. Specifies references to assemblies that change during the build process. For example, a Microsoft Visual Studio 2005 solution may contain one project that references the compiled output of another project. In this case, the compiled output of the second project can be added to AssembliesGeneratedDuringBuild. Note: AssembliesGeneratedDuringBuild must contain references to the complete set of assemblies that are generated by a build solution. |
AssemblyName |
Required String parameter. Specifies the short name of the assembly that is generated for a project. For example, if a project is generating a Microsoft Windows executable whose name is WinExeAssembly.exe, the AssemblyName parameter has a value of WinExeAssembly. |
GeneratedBaml |
Optional ITaskItem[] output parameter. Contains the list of generated files in XAML binary format. |
KnownReferencePaths |
Optional String[] parameter. Specifies references to assemblies that are never changed during the build process. Includes assemblies that are located in the global assembly cache (GAC), in a Microsoft .NET Framework installation directory, and so on. |
Language |
Required String parameter. Specifies the managed language that the compiler supports. The valid options are C#, VB, JScript, and C++. |
LocalizationDirectivesToLocFile |
Optional String parameter. Specifies how to generate localization information for each source XAML file. The valid options are None, CommentsOnly, and All. |
OutputPath |
Required String parameter. Specifies the directory in which the generated XAML binary format files are generated. |
OutputType |
Required String parameter. Specifies the type of assembly that is generated by a project. The valid options are winexe, exe, library, and netmodule. |
References |
Optional ITaskItem[] parameter. Specifies the list of references from files to assemblies that contain the types that are used in the XAML files. One reference is to the assembly that was generated by the GenerateTemporaryTargetAssembly task, which must be run before the MarkupCompilePass2 task. |
RootNamespace |
Optional String parameter. Specifies the root namespace for classes that are inside the project. RootNamespace is also used as the default namespace of a generated managed code file when the corresponding XAML file does not include the x:Class attribute. |
XAMLDebuggingInformation |
Optional Boolean parameter. When true, diagnostic information is generated and included in the compiled XAML in order to aid debugging. |
Remarks
Before you run MarkupCompilePass2, you must generate a temporary assembly that contains the types that are used by the XAML files whose markup compilation pass were deferred. You generate the temporary assembly by running the GenerateTemporaryTargetAssembly task.
A reference to the generated temporary assembly is provided to MarkupCompilePass2 when it runs, allowing the XAML files whose compilation was deferred in the first markup compilation pass to now be compiled to binary format.
Example
The following example shows how to use the MarkupCompilePass2 task to perform a second pass compilation.
<Project xmlns="https://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>
See Also
Concepts
Building a WPF Application (WPF)
WPF XAML Browser Applications Overview