ItemGroup 項目 (MSBuild)

發行項
06/09/2015

包含一組使用者定義的 Item 項目。 MSBuild 專案中使用的每個項目 (Item)，都必須指定為 ItemGroup 項目 (Element) 的子系。

<ItemGroup Condition="'String A' == 'String B'">
    <Item1>... </Item1>
    <Item2>... </Item2>
</ItemGroup>

屬性和項目

下列章節會說明屬性、子項目和父項目。

屬性

屬性	描述
Condition	選擇性屬性。要評估的條件。如需詳細資訊，請參閱MSBuild 條件。

子項目

元素	描述
項目	定義建置 (Build) 程序的輸入。 ItemGroup 中可能有零或多個 Item 項目。

父項目

元素	描述
專案	MSBuild 專案檔的必要根項目。
目標	從 .NET Framework 3.5 開始，ItemGroup 項目都可以出現在 Target 項目內。如需詳細資訊，請參閱MSBuild 目標。

範例

在下列程式碼範例中，示範了在 ItemGroup 項目內部宣告的使用者定義項目集合 Res 和 CodeFiles。在 Res 項目集合中的每個項目，都含有使用者定義的子 ItemMetadata 項目。

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <Res Include = "Strings.fr.resources" >
            <Culture>fr</Culture>
        </Res>
        <Res Include = "Dialogs.fr.resources" >
            <Culture>fr</Culture>
        </Res>

        <CodeFiles Include="**\*.cs" Exclude="**\generated\*.cs" />
        <CodeFiles Include="..\..\Resources\Constants.cs" />
    </ItemGroup>
...
</Project>