Output 要素 (MSBuild)

  • [アーティクル]

タスクの出力値をアイテムおよびプロパティに格納します。

<Output TaskParameter="Parameter"
    PropertyName="PropertyName" 
    Condition = "'String A' == 'String B'" />

属性および要素

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

属性

属性

Description

TaskParameter

必須の属性です。

タスクの出力パラメーターの名前です。

PropertyName

PropertyName 属性または ItemName 属性のいずれかが必要です。

タスクの出力パラメーター値を受け取るプロパティです。 プロジェクトでは、$(PropertyName) という構文を使用してプロパティを参照できます。 このプロパティ名には、新しいプロパティ名を指定することも、プロジェクトで既に定義されているプロパティ名を指定することもできます。

ItemName が使用されている場合、この属性は使用できません。

ItemName

PropertyName 属性または ItemName 属性のいずれかが必要です。

タスクの出力パラメーター値を受け取るアイテムです。 プロジェクトでは、@(ItemName) という構文を使用してアイテムを参照できます。 このアイテム名には、新しいアイテム名を指定することも、プロジェクトに既に定義してあるアイテム名を指定することもできます。

PropertyName が使用されている場合、この属性は使用できません。

Condition

省略可能な属性です。

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

子要素

なし。

親要素

要素

Description

タスク

MSBuild タスクのインスタンスを作成し、実行します。

使用例

次のコード例は、Target 要素内で実行されている Csc タスクを示しています。 タスク パラメーターに渡されるアイテムおよびプロパティは、この例の範囲外で宣言されています。 出力パラメーター OutputAssembly からの値は、FinalAssemblyName アイテムに格納され、出力パラメーター BuildSucceeded からの値は、BuildWorked プロパティに格納されます。 詳細については、「MSBuild タスク」を参照してください。

<Target Name="Compile" DependsOnTargets="Resources">
    <Csc  Sources="@(CSFile)"
            TargetType="library"
            Resources="@(CompiledResources)"
            EmitDebugInformation="$(includeDebugInformation)"
            References="@(Reference)"
            DebugType="$(debuggingType)"
            OutputAssembly="$(builtdir)\$(MSBuildProjectName).dll" >
        <Output TaskParameter="OutputAssembly"
                  ItemName="FinalAssemblyName" />
        <Output TaskParameter="BuildSucceeded"
                  PropertyName="BuildWorked" />
    </Csc>
</Target>

参照

概念

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

MSBuild タスク