ItemGroup 元素 (MSBuild)

包含一组用户定义的 Item 元素。 必须将 MSBuild 项目中使用的每个项都指定为 ItemGroup 元素的子元素。

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

特性和元素

以下几节描述了特性、子元素和父元素。

特性

特性

描述

Condition

可选特性。 要计算的条件。 有关更多信息,请参见MSBuild 条件

子元素

元素

描述

为生成过程定义输入。 ItemGroup 中可能有零个或零个以上的 Item 元素。

父元素

元素

描述

项目

MSBuild 项目文件必需的根元素。

目标

从 .NET Framework 3.5 开始,ItemGroup 元素可以出现在 Target 元素内。 有关更多信息,请参见MSBuild 目标

示例

下面的代码示例演示了用户定义的项集合 Res 和 CodeFiles,这些项集合在 ItemGroup 元素的内部声明。 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>

请参见

参考

常用的 MSBuild 项目项

概念

MSBuild 项目文件架构引用

MSBuild 项