Output 要素 (MSBuild)

  • [アーティクル]

更新 : 2007 年 11 月

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

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

属性と要素

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

属性

属性

説明

TaskParameter

必須属性

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

PropertyName

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

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

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

ItemName

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

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

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

Condition

省略可能属性

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

子要素

なし。

親要素

要素

説明

Task

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 タスク