UsingTask 要素 (MSBuild)

更新 : 2007 年 11 月

Task 要素内で参照されているタスクを、そのタスクの実装を格納しているアセンブリに対応付けます。

<UsingTask TaskName="TaskName"
    AssemblyName = "AssemblyName" 
    Condition="'String A'=='String B'" />

属性と要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性	説明
AssemblyName	AssemblyName 属性または AssemblyFile 属性が必要です。 読み込むアセンブリの名前です。AssemblyName 属性は厳密な名前のアセンブリを受け入れますが、必須ではありません。この属性を使用すると、.NET Framework で Load メソッド経由でアセンブリを読み込んだ場合と同じ結果になります。 AssemblyFile 属性が使用されている場合には、この属性は使用できません。
AssemblyFile	AssemblyName 属性または AssemblyFile 属性が必要です。 アセンブリへのファイル パスです。この属性は、完全パスと相対パスの両方を受け入れます。相対パスは、UsingTask 要素が宣言されたプロジェクトまたは targets ファイルのディレクトリに対して相対です。この属性を使用すると、.NET Framework で LoadFrom メソッド経由でアセンブリを読み込んだ場合と同じ結果になります。 AssemblyName 属性が使用されている場合には、この属性は使用できません。
TaskName	必須属性 アセンブリから参照するタスクの名前です。多義的になる可能性があるときには、この属性には完全な名前空間を指定するようにしてください。多義的な名前を指定すると、MSBuild で名前が完全に一致しないタスクが選択され、予期しない結果になる場合があります。
Condition	省略可能属性 評価するための条件です。詳細については、「MSBuild の条件」を参照してください。

子要素

なし。

親要素

要素	説明
Project	MSBuild プロジェクト ファイルの必須のルート要素です。

解説

環境変数、コマンド ライン、およびプロジェクトレベル プロパティは、明示的に、またはインポートされたプロジェクト ファイル経由でプロジェクト ファイル内に存在する限り、UsingTask 要素内の任意の場所から参照できます。詳細については、「MSBuild タスク」を参照してください。

メモ :
MSBuild エンジンを使用してグローバルに登録された .tasks ファイルの 1 つから UsingTask 要素が使用されている場合、プロジェクトレベル プロパティは意味を持ちません。これらのプロパティは、MSBuild に対するグローバルなプロパティではありません。

使用例

次の例は、UsingTask 要素を AssemblyName 属性を指定して使用する方法を示しています。

<UsingTask TaskName="Microsoft.Build.Tasks.Csc"
              AssemblyName="Microsoft.Build.Tasks" />

次の例は、UsingTask 要素を AssemblyFile 属性を指定して使用する方法を示しています。

<UsingTask TaskName="Email"
              AssemblyFile="c:\myTasks\myTask.dll" />

参照

概念

MSBuild タスク

MSBuild プロジェクト ファイル スキーマ リファレンス

その他の技術情報

MSBuild タスク リファレンス