Поделиться через


MarkupCompilePass2 - задача

Задача MarkupCompilePass2 выполняет второй проход компиляции разметки на файлах XAML, которые ссылаются на типы в том же проекте.

Параметры задачи

Параметр Описание
AlwaysCompileMarkupFilesInSeparateDomain Необязательный параметр Boolean .

Указывает, следует ли запускать задачу в отдельном AppDomain. Если этот параметр возвращает false, задача выполняется в том же AppDomain, что и MSBuild. Это позволяет выполнить задачу быстрее. Если этот параметр возвращает значение true, то задача выполняется во втором AppDomain, который изолирован от MSBuild и работает медленнее.
AssembliesGeneratedDuringBuild Необязательный параметр типа String[].

Задает ссылки на сборки, которые изменяются в процессе сборки. Например, решение Visual Studio может содержать один проект, который ссылается на выходные данные компиляции другого проекта. В этом случае выходные данные компиляции второго проекта можно добавить в AssembliesGeneratedDuringBuild.

Примечание. Элемент AssembliesGeneratedDuringBuild должен содержать ссылки на полный набор сборок, созданных решением сборки.
AssemblyName Обязательный параметр string.

Задает короткое имя сборки, которая создается для проекта. Например, если проект создает исполняемый файл с именем WinExeAssembly.exe, то параметр AssemblyName имеет значение WinExeAssembly.
GeneratedBaml Необязательный параметр вывода ITaskItem[].

Содержит список созданных файлов в двоичном формате XAML.
KnownReferencePaths Необязательный параметр типа String[].

Задает ссылки на сборки, которые не изменяются в процессе сборки. Сюда включаются сборки, расположенные в глобальном кэше сборок, в каталоге установки .NET и т. д.
Language Обязательный параметр string.

Задает управляемый язык, который поддерживает компилятор. Допустимые значения: C#, VB, JScript и C++.
LocalizationDirectivesToLocFile Необязательный параметр String .

Указывает, как создать сведения о локализации для каждого исходного файла XAML. Допустимые значения: None, CommentsOnly и All.
OutputPath Обязательный параметр string.

Указывает каталог, в котором сохраняются созданные файлы XAML в двоичном формате.
OutputType Обязательный параметр string.

Задает тип сборки, которая создается проектом. Допустимые значения: winexe, exe, library и netmodule.
References Необязательный параметр ITaskItem[].

Указывает список содержащихся в файлах ссылок на сборки, которые содержат типы, используемые в файлах XAML. Одна ссылка указывает на сборку, созданную задачей GenerateTemporaryTargetAssembly, которая должна выполняться перед задачей MarkupCompilePass2.
RootNamespace Необязательный параметр String .

Задает корневое пространство имен для классов, которые находятся внутри проекта. RootNamespace также используется как пространство имен по умолчанию для созданного файла управляемого кода, если соответствующий файл XAML не содержит атрибут x:Class.
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>

См. также