Task 要素 (MSBuild)Task Element (MSBuild)

MSBuildMSBuild タスクのインスタンスを作成し、実行します。Creates and executes an instance of an MSBuildMSBuild task. 要素名は、作成されるタスクの名前によって決まります。The element name is determined by the name of the task being created.

<Project><Project>
<Target><Target>

構文Syntax

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

属性および要素Attributes and Elements

以降のセクションでは、属性、子要素、および親要素について説明します。The following sections describe attributes, child elements, and parent elements.

属性Attributes

属性Attribute 説明Description
Condition 省略可能な属性です。Optional attribute. 評価する条件です。Condition to be evaluated. 詳細については、条件をご覧ください。For more information, see Conditions.
ContinueOnError 省略可能な属性です。Optional attribute. 次の値のいずれかを含めることができます。Can contain one of the following values:

- WarnAndContinue または true- WarnAndContinue or true. タスクが失敗すると、Target 要素の後続のタスクとビルドの実行が継続し、タスクのすべてのエラーが警告として扱われます。When a task fails, subsequent tasks in the Target element and the build continue to execute, and all errors from the task are treated as warnings.
- ErrorAndContinue- ErrorAndContinue. タスクが失敗すると、Target 要素の後続のタスクとビルドの実行が継続し、タスクのすべてのエラーがエラーとして扱われます。When a task fails, subsequent tasks in the Target element and the build continue to execute, and all errors from the task are treated as errors.
- ErrorAndStop または false (既定)。- ErrorAndStop or false (default). タスクが失敗すると、Target 要素の残りのタスクとビルドは実行されず、Target 要素全体とビルドは失敗したと見なされます。When a task fails, the remaining tasks in the Target element and the build aren't executed, and the entire Target element and the build is considered to have failed.

バージョン 4.5 より前の .NET Framework では、true 値と false 値のみがサポートされます。Versions of the .NET Framework before 4.5 supported only the true and false values.

詳細については、「方法: タスクで発生したエラーを無視する」を参照してください。For more information, see How to: Ignore Errors in Tasks.
Parameter タスク クラスに [Required] 属性のラベルが付けられた 1 つ以上のプロパティが含まれる場合は必須です。Required if the task class contains one or more properties labeled with the [Required] attribute.

パラメーター値とその値を含むユーザー定義のタスク パラメーターです。A user-defined task parameter that contains the parameter value as its value. Task 要素には任意の数のパラメーターを指定でき、各属性はタスク クラスの .NET プロパティにマップされます。There can be any number of parameters in the Task element, with each attribute mapping to a .NET property in the task class.

子要素Child Elements

要素Element 説明Description
出力Output タスクからの出力をプロジェクト ファイルに格納します。Stores outputs from the task in the project file. 1 つのタスクに 0 個以上の Output 要素を指定できます。There may be zero or more Output elements in a task.

親要素Parent Elements

要素Element 説明Description
TargetTarget MSBuildMSBuild タスクのコンテナー要素。Container element for MSBuildMSBuild tasks.

コメントRemarks

MSBuildMSBuild プロジェクト ファイル内の Task 要素は、タスクのインスタンスを作成し、そこにプロパティを設定して実行します。A Task element in an MSBuildMSBuild project file creates an instance of a task, sets properties on it, and executes it. Output 要素は、プロジェクト ファイル内の別の場所で使用するプロパティまたは項目に出力パラメーターを格納します。The Output element stores output parameters in properties or items to be used elsewhere in the project file.

タスクの親 Target 要素に OnError 要素がある場合は、タスクが失敗して ContinueOnError の値が false の場合も評価されます。If there are any OnError elements in the parent Target element of a task, they will still be evaluated if the task fails and ContinueOnError has a value of false. タスクについて詳しくは、「MSBuild タスク」をご覧ください。For more information on tasks, see Tasks.

Example

次のコード例は、Csc タスク クラスのインスタンスを作成し、6 つのプロパティを設定し、タスクを実行します。The following code example creates an instance of the Csc task class, sets six of the properties, and executes the task. 実行後に、オブジェクトの OutputAssembly プロパティの値は FinalAssemblyName という項目一覧に配置されます。After execution, the value of the OutputAssembly property of the object is placed into an item list named 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>  

関連項目See Also

タスク Tasks
Task Reference (タスク リファレンス) Task Reference
プロジェクト ファイル スキーマ リファレンスProject File Schema Reference