Поделиться через


Элемент ItemGroup (MSBuild)

Содержит набор элементов , определенных пользователем. Каждый элемент, используемый в проекте MSBuild, должен быть указан как дочерний ItemGroup элемент элемента.

<Project><ItemGroup>

Синтаксис

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

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние элементы и родительские элементы.

Attributes

Свойство Description
Condition Необязательный атрибут. Условие для оценки. Дополнительные сведения см. в разделе "Условия".
Label Необязательный атрибут. Идентифицирует ItemGroup.

Дочерние элементы

Элемент Description
Элемент Определяет входные данные для процесса сборки. В элементе может ItemGroupбыть ноль или больше Item элементов.

В дополнение к универсальному Item элементу ItemGroup позволяет дочерним элементам, представляющим типы элементов, таких как Reference, CompileProjectReferenceи другие элементы, перечисленные в элементах проекта Common MSBuild.

Родительские элементы

Элемент Description
Проект Обязательный корневой элемент файла проекта MSBuild.
Цель Элемент ItemGroup может отображаться внутри Target элемента. Дополнительные сведения см. в разделе "Целевые объекты".

Example

В следующем примере кода показаны пользовательские коллекции Res элементов и CodeFiles объявленные внутри ItemGroup элемента. Каждый элемент в Res коллекции элементов содержит определяемый пользователем дочерний элемент ItemMetadata .

<Project>
    <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>

В простом файле проекта обычно используется один ItemGroup элемент, но можно также использовать несколько ItemGroup элементов. При использовании нескольких ItemGroup элементов элементы объединяются в один ItemGroup. Например, некоторые элементы могут быть включены отдельным ItemGroup элементом, определенным в импортированном файле.

Элементы ItemGroups могут применять условия с помощью атрибута Condition . В этом случае элементы добавляются только в список элементов, если условие выполнено. См. условия MSBuild

Атрибут Label используется в некоторых системах сборки в качестве способа управления поведением сборки. Его можно использовать только в объявлениях, как способ создания более понятных скриптов MSBuild или в качестве параметра управления, чтобы повлиять на действия сборки.

См. также