Task 要素 (MSBuild)

  • [アーティクル]

更新 : 2007 年 11 月

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

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

属性と要素

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

属性

属性

説明

Condition

省略可能属性。評価する条件です。詳細については、「MSBuild の条件」を参照してください。

ContinueOnError

省略可能属性。ブール型の属性です。指定しなかった場合の既定値は false です。ContinueOnError を false に設定すると、タスクが失敗した場合には、Target 要素内の残りのタスクは実行されず、Target 要素全体が失敗したと見なされます。

この属性が true の場合、現在のタスクが失敗しても Target 要素内のその後のタスクは引き続き実行され、タスクのすべてのエラーは警告として処理されます。

Parameter

タスク クラスに [Required] 属性を持つプロパティが含まれている場合には必ず指定します。

ユーザー定義のタスク パラメータであり、値としてパラメータ値を持ちます。Task 要素は、パラメータの各属性がこのタスク クラスの .NET プロパティに対応付けられた、任意の数のパラメータを持つことができます。

子要素

要素

説明

Output

プロジェクト ファイル内のタスクの出力を格納します。タスクには 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 タスク リファレンス