MarkupCompilePass1 タスク

MarkupCompilePass1 タスクは、ローカライズできない Extensible Application Markup Language (XAML) プロジェクト ファイルをコンパイル済みバイナリ形式に変換します。

タスク パラメーター

解説

MarkupCompilePass1 タスクは、通常、XAML をバイナリ形式にコンパイルしてコード ファイルを生成します。 同じプロジェクト内で定義される型への参照が XAML ファイルに含まれている場合、MarkupCompilePass1 は、バイナリ形式へのコンパイルを 2 番目のマークアップ コンパイル パス (MarkupCompilePass2) まで延期します。 このようなファイルでは、参照しているローカル定義の型がコンパイルされるまで待つ必要があるため、コンパイルを延期する必要があります。 ただし、XAML ファイルに x:Class 属性がある場合、MarkupCompilePass1 はこのファイルの言語固有のコード ファイルを生成します。

XAML ファイルに x:Uid 属性を使用する要素が含まれている場合、そのファイルはローカライズ可能です。

<Page x:Class="WPFMSBuildSample.Page1"
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    x:Uid="Page1Uid"
    >
  ...
</Page>

XAML ファイルは、clr-namespace 値を使用して現在のプロジェクトの名前空間を参照する XML 名前空間を宣言している場合、ローカルに定義された型を参照します。

<Page x:Class="WPFMSBuildSample.Page1"
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:localNamespace="clr-namespace:WPFMSBuildSample"
    >
    <Grid>
      <Grid.Resources>
        <localNameSpace:LocalType x:Key="localType" />
      </Grid.Resources>
      ...
    </Grid>
</Page>

いずれかの XAML ファイルがローカライズ可能であるか、またはローカルに定義された型を参照している場合は、2 番目のマークアップ コンパイル パスが必要です。このパスでは、GenerateTemporaryTargetAssembly タスク を実行し、次に MarkupCompilePass2 タスク を実行する必要があります。

使用例

3 つの Page XAML ファイルをバイナリ形式ファイルに変換する方法を次の例に示します。 Page1 には、Class1 という型への参照が含まれます。この型はプロジェクトのルート名前空間内にあるため、このマークアップ コンパイル パスではバイナリ形式ファイルに変換されません。 代わりに、GenerateTemporaryTargetAssembly タスク が実行され、次に MarkupCompilePass2 タスク が実行されます。

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
  <UsingTask 
    TaskName="Microsoft.Build.Tasks.Windows.MarkupCompilePass1" 
    AssemblyFile="C:\Program Files\Reference Assemblies\Microsoft\Framework\v3.0\PresentationBuildTasks.dll" />
  <Target Name="MarkupCompilePass1Task">
    <MarkupCompilePass1 
      AssemblyName="WPFMSBuildSample"
      Language="C#"
      OutputType="WinExe"
      OutputPath="obj\Debug\"
      ApplicationMarkup="App.xaml"
      PageMarkup="Page1.xaml;Page2.xaml;Page3.xaml"
      SourceCodeFiles="Class1.cs"
      References="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>

参照

概念

WPF アプリケーション (WPF) のビルド

WPF XAML ブラウザー アプリケーションの概要

その他の技術情報

WPF MSBuild のリファレンス

WPF MSBuild タスク リファレンス

MSBuild リファレンス

MSBuild タスク リファレンス