When 要素 (MSBuild)

Choose 要素で選ぶ対象のコード ブロックを指定します。

<Project>
<Choose>
<When>
<Choose>
...
<Otherwise>
<Choose>
...

構文

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

属性および要素

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

属性

属性 説明
条件 必須の属性です。

評価する条件です。 詳細については、条件をご覧ください。

子要素

要素 説明
Choose 省略可能な要素です。

子要素を評価して、実行するコードのセクションを 1 つ選びます。 Choose 要素に 0 個以上の When 要素があります。
ItemGroup 省略可能な要素です。

ユーザー定義 Item 要素のセットが含まれます。 ItemGroup 要素に 0 個以上の When 要素があります。
PropertyGroup 省略可能な要素です。

ユーザー定義の Property 要素のセットを格納します。 PropertyGroup 要素に 0 個以上の When 要素があります。

親要素

要素 説明
Choose 要素 [MSBuild] 子要素を評価して、実行するコードのセクションを 1 つ選びます。

コメント

Condition 属性が true と評価された場合、その When 要素の子の ItemGroup 要素と PropertyGroup 要素が実行されて、後続の When 要素はすべてスキップされます。

ChooseWhenOtherwise 要素を組み合わせて使って、実行される可能性のある複数のコード セクションから 1 つを選びます。 詳細については、「条件構造」を参照してください。

次のプロジェクトでは、Choose 要素を使って、設定する When 要素のプロパティ値のセットを選んでいます。 両方の When 要素の Condition 属性が false と評価された場合、Otherwise 要素のプロパティ値が設定されます。

<Project  
    xmlns="http://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>  

関連項目

条件構造
プロジェクト ファイル スキーマ リファレンス