Item 요소(MSBuild)
사용자 정의 항목 및 해당 메타데이터를 포함합니다. MSBuild 프로젝트에서 사용되는 모든 항목은 ItemGroup 요소의 자식으로 지정해야 합니다.
<Item Include="*.cs"
Exclude="MyFile.cs"
Remove="RemoveFile.cs"
Condition="'String A'=='String B'" >
<ItemMetadata1>...</ItemMetadata1>
<ItemMetadata2>...</ItemMetadata2>
</Item>
특성 및 요소
다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.
특성
특성 |
설명 |
|---|---|
Include |
필수 특성입니다. 항목 목록에 포함할 파일 또는 와일드카드입니다. |
Exclude |
선택적 특성입니다. 항목 목록에서 제외할 파일 또는 와일드카드입니다. |
Condition |
선택적 특성입니다. 평가할 조건입니다. 자세한 내용은 MSBuild 조건을 참조하십시오. |
Remove |
선택적 특성입니다. 항목 목록에서 제거할 파일 또는 와일드카드입니다. 이 특성은 Target에 포함된 ItemGroup의 항목에 대해 지정된 경우에만 유효합니다. |
KeepMetadata |
선택적 특성입니다. 대상 항목에 추가할 소스 항목의 메타데이터입니다. 이름이 세미콜론으로 구분된 목록에 지정되어 있는 메타데이터만 소스 항목에서 대상 항목으로 전송됩니다. 자세한 내용은 MSBuild 항목을 참조하십시오. 이 특성은 Target에 포함된 ItemGroup의 항목에 대해 지정된 경우에만 유효합니다. |
RemoveMetadata |
선택적 특성입니다. 대상 항목에으로 전송하지 않을 소스 항목의 메타데이터입니다. 이름이 세미콜론으로 구분된 이름 목록에 포함되어 있는 메타데이터를 제외한 모든 메타데이터는 소스 항목에서 대상 항목으로 전송됩니다. 자세한 내용은 MSBuild 항목을 참조하십시오. 이 특성은 Target에 포함된 ItemGroup의 항목에 대해 지정된 경우에만 유효합니다. |
KeepDuplicates |
선택적 특성입니다. 항목이 기존 항목의 정확한 복제본인 경우 대상 그룹에 추가할지 여부를 지정합니다. 소스 항목과 대상 항목의 Include 값은 같고 메타데이터는 다르면 KeepDuplicates가 false로 설정되어 있어도 항목이 추가됩니다. 자세한 내용은 MSBuild 항목을 참조하십시오. 이 특성은 Target에 포함된 ItemGroup의 항목에 대해 지정된 경우에만 유효합니다. |
자식 요소
요소 |
설명 |
|---|---|
항목 메타데이터 값을 포함하는 사용자 정의 항목 메타데이터 키입니다. 항목에는 ItemMetadata 요소가 없을 수도 있고 하나 이상 있을 수도 있습니다. |
부모 요소
요소 |
설명 |
|---|---|
항목의 그룹화 요소입니다. |
설명
Item 요소는 빌드 시스템에 대한 입력을 정의하며 사용자 정의 컬렉션 이름을 기준으로 하여 항목 컬렉션으로 그룹화됩니다. 이러한 항목 컬렉션은 빌드 프로세스의 단계를 수행하기 위해 컬렉션의 개별 항목을 사용하는 작업의 매개 변수로 사용할 수 있습니다. 자세한 내용은 MSBuild 항목을 참조하십시오.
@(myType) 표기법을 사용하면 myType 형식의 항목 컬렉션을 세미콜론으로 구분된 문자열 목록으로 확장한 다음 매개 변수로 전달할 수 있습니다. 매개 변수가 string 형식인 경우 매개 변수 값은 세미콜론으로 구분된 요소 목록입니다. 매개 변수가 문자열 배열(string[])이면 각 요소는 세미콜론의 위치를 기준으로 배열에 삽입됩니다. 작업 매개 변수가 ITaskItem[] 형식이면 값은 항목 컬렉션의 내용(연결된 메타데이터 포함)입니다. 세미콜론 이외의 문자를 사용하여 각 항목을 구분하려면 @(myType, '구분 기호') 구문을 사용합니다.
MSBuild 엔진은 *, ? 등의 와일드카드와 /**/*.cs 등의 재귀 와일드카드를 평가할 수 있습니다. 자세한 내용은 MSBuild 항목을 참조하십시오.
예제
다음 코드 예제에서는 CSFile 형식의 두 항목을 선언하는 방법을 보여 줍니다. 두 번째로 선언된 항목은 MyMetadata가 HelloWorld로 설정된 메타데이터를 포함합니다.
<ItemGroup>
<CSFile Include="engine.cs; form.cs" />
<CSFile Include="main.cs" >
<MyMetadata>HelloWorld</MyMetadata>
</CSFile>
</ItemGroup>