When 要素 (MSBuild)

更新 : 2007 年 11 月

Choose 要素で選択する、コード ブロックの候補を指定します。

<When Condition="'StringA'=='StringB'">
    <PropertyGroup>... </PropertyGroup>
    <ItemGroup>... </ItemGroup>
    <Choose>... </Choose>
</When>

属性と要素

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

属性

属性	説明
Condtition	必須属性 評価するための条件です。詳細については、「MSBuild の条件」を参照してください。

子要素

要素	説明
Choose	省略可能な要素 実行する 1 つのコード セクションを選択するために子要素を評価します。When 要素には 0 個以上の Choose 要素を設定できます。
ItemGroup	省略可能な要素 ユーザーが定義する、一連の Item 要素を含みます。When 要素には 0 個以上の ItemGroup 要素を設定できます。
PropertyGroup	省略可能な要素 ユーザーが定義する、一連の Property 要素を含みます。When 要素には、0 個以上のPropertyGroup 要素を設定できます。

親要素

要素	説明
Choose 要素 (MSBuild)	実行する 1 つのコード セクションを選択するために子要素を評価します。

解説

Condition 属性が true と評価された場合には、When 要素の ItemGroup 子要素および PropertyGroup 子要素が実行され、以降の When 要素はすべてスキップされます。

Choose 要素、When 要素、および Otherwise 要素は、いくつかのコード セクションの中から、実行する 1 つを選択するために、一緒に使用します。詳細については、「MSBuild の条件構造」を参照してください。

使用例

次のプロジェクトでは、Choose 要素を使用して、When 要素内のプロパティ値の組のうち、設定対象となる組を選択しています。両方の When 要素の Condition 属性の評価結果が false の場合には、Otherwise 要素内のプロパティ値が設定されます。

<Project
    xmlns="https://schemas.microsoft.com/developer/msbuild/2003" >
    <PropertyGroup>
        <Configuration Condition="'$(Configuration)' == ''">Debug</Configuration>
        <OutputType>Exe</OutputType>
        <RootNamespace>ConsoleApplication1</RootNamespace>
        <AssemblyName>ConsoleApplication1</AssemblyName>
        <WarningLevel>4</WarningLevel>
    </PropertyGroup>
    <Choose>
        <When Condition=" '$(Configuration)'=='debug' ">
            <PropertyGroup>
                <DebugSymbols>true</DebugSymbols>
                <DebugType>full</DebugType>
                <Optimize>false</Optimize>
                <OutputPath>.\bin\Debug\</OutputPath>
                <DefineConstants>DEBUG;TRACE</DefineConstants>
            </PropertyGroup>
            <ItemGroup>
                <Compile Include="UnitTesting\*.cs" />
                <Reference Include="NUnit.dll" />
            </ItemGroup>
        </When>
        <When Condition=" '$(Configuration)'=='retail' ">
            <PropertyGroup>
                <DebugSymbols>false</DebugSymbols>
                <Optimize>true</Optimize>
                <OutputPath>.\bin\Release\</OutputPath>
                <DefineConstants>TRACE</DefineConstants>
            </PropertyGroup>
        </When>
        <Otherwise>
            <PropertyGroup>
                <DebugSymbols>true</DebugSymbols>
                <Optimize>false</Optimize>
                <OutputPath>.\bin\$(Configuration)\</OutputPath>
                <DefineConstants>DEBUG;TRACE</DefineConstants>
            </PropertyGroup>
        </Otherwise>
    </Choose>
    <Import Project="$(MSBuildBinPath)\Microsoft.CSharp.targets" />
</Project>

参照

概念

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

参照

MSBuild の条件構造