사용자 정의 항목 요소 집합을 포함합니다. MSBuild 프로젝트에 사용되는 모든 항목은 요소의 ItemGroup 자식으로 지정해야 합니다.
<Project><ItemGroup>
Syntax
<ItemGroup Condition="'String A' == 'String B'"
Label="Label">
<Item1>... </Item1>
<Item2>... </Item2>
</ItemGroup>
특성 및 요소
다음 섹션에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.
Attributes
| 특성 | Description |
|---|---|
Condition |
선택적 특성입니다. 평가할 조건입니다. 자세한 내용은 조건을 참조하세요. |
Label |
선택적 특성입니다. 를 식별합니다 ItemGroup. |
자식 요소
| 요소 | Description |
|---|---|
| 항목 | 빌드 프로세스에 대한 입력을 정의합니다. 에 요소가 ItemGroup0개 이상 Item 있을 수 있습니다. |
ItemGroup은 제네릭 Item 요소 외에도 Common MSBuild 프로젝트 항목에 나열된 항목 형식(예: Reference, ProjectReferenceCompile및 기타)을 나타내는 자식 요소를 허용합니다.
부모 요소
| 요소 | Description |
|---|---|
| 프로젝트 | MSBuild 프로젝트 파일의 필수 루트 요소입니다. |
| 과녁 |
ItemGroup 요소는 요소 내부에 Target 나타날 수 있습니다. 자세한 내용은 대상을 참조하세요. |
Example
다음 코드 예제에서는 요소 내에서 ItemGroup 선언된 사용자 정의 항목 컬렉션을 ResCodeFiles 보여 줍니다. 항목 컬렉션의 각 항목 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 스크립트를 만들거나 빌드 작업에 영향을 미치는 컨트롤 설정으로 선언에서만 사용할 수 있습니다.