Task 要素 (MSBuild)

MSBuild タスクのインスタンスを作成し、実行します。要素名は、作成しているタスクの名前に従って決定されます。

<Task Parameter1="Value1"... ParameterN="ValueN"
    ContinueOnError="WarnAndContinue/true/ErrorAndContinue/ErrorAndStop/false"
    Condition="'String A' == 'String B'" >
    <Output... />
</Task>

属性および要素

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

属性

属性	説明
Condition	省略可能な属性です。評価する条件です。詳細については、「MSBuild の条件」を参照してください。
ContinueOnError	省略可能な属性です。次の値の1個含めることができます。: WarnAndContinue か true。タスクが失敗した場合は、[ターゲット] の要素とビルドのその後のタスクは実行を継続タスクのすべてのエラーは警告として処理されます。 ErrorAndContinue。タスクが失敗した場合は、Target の要素とビルドのその後のタスクは実行を継続タスクのすべてのエラーはエラーとして扱われます。 ErrorAndStop か false (既定値)。タスクが失敗した場合は、Target の要素とビルドの残りのタスクは実行されず、Target の要素全体とビルドが失敗したと見なされます。 4.5より前のバージョンの.NET Frameworkは true と false の値をサポートしていました。 詳細については、「方法 : タスクで発生したエラーを無視する」を参照してください。
Parameter	タスク クラスに [Required] 属性を持つプロパティが含まれている場合には必ず指定します。 ユーザー定義のタスク パラメーターであり、値としてパラメーター値を持ちます。Task 要素は、パラメーターの各属性がこのタスク クラスの .NET プロパティに対応付けられた、任意の数のパラメーターを持つことができます。

子要素

要素	説明
出力	プロジェクト ファイル内のタスクの出力を格納します。タスクには 0 個以上の Output 要素を設定できます。

親要素

要素	説明
Target	MSBuild タスクのコンテナー要素です。

解説

MSBuild プロジェクト ファイルの Task 要素では、タスクのインスタンスを作成し、このインスタンスにプロパティを設定し、これを実行します。Output 要素では、プロジェクト ファイルの他の場所で使用するために、プロパティやアイテムに出力パラメーターを格納します。

タスクの親 Target 要素に OnError 要素がある場合、このタスクが失敗し、ContinueOnError が false に設定してあるときには、これらの要素も評価されます。タスクの詳細については、「MSBuild タスク」を参照してください。

使用例

Csc タスク クラスのインスタンスを作成し、プロパティを 6 個設定し、タスクを実行するコード例を次に示します。実行が終了すると、オブジェクトの OutputAssembly プロパティの値が、FinalAssemblyName という名前のアイテム リストに格納されます。

<Target Name="Compile" DependsOnTarget="Resources" >
    <Csc Sources="@(CSFile)"
          TargetType="library"
          Resources="@(CompiledResources)"
          EmitDebugInformation="$(includeDebugInformation)"
          References="@(Reference)"
          DebugType="$(debuggingType)" >
        <Output TaskParameter="OutputAssembly"
                  ItemName="FinalAssemblyName" />
    </Csc>
</Target>

参照

概念

MSBuild タスク

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

その他の技術情報

MSBuild タスク リファレンス