CreateItem 작업
항목 컬렉션을 입력 항목으로 채웁니다.이렇게 하면 항목을 한 목록에서 다른 목록으로 복사할 수 있습니다.
[!참고]
이 작업은 더 이상 사용되지 않습니다..NET Framework 3.5부터 항목 그룹은 대상 요소 내에 배치할 수 있습니다.자세한 내용은 MSBuild 항목을 참조하십시오.
특성
다음 표에서는 CreateItem 작업의 매개 변수에 대해 설명합니다.
Parameter |
설명 |
|---|---|
AdditionalMetadata |
선택적 String 배열 매개 변수입니다. 출력 항목에 연결할 추가 메타데이터를 지정합니다.다음 구문을 사용하여 항목에 대한 메타데이터 이름과 값을 지정합니다. MetadataName=MetadataValue 메타데이터 이름/값 쌍이 여러 개인 경우 세미콜론으로 구분해야 합니다.이름이나 값 자체에 세미콜론 또는 기타 특수 문자가 들어 있으면 이를 이스케이프해야 합니다.자세한 내용은 방법: MSBuild의 이스케이프 특수 문자를 참조하십시오. |
Exclude |
선택적 ITaskItem[] 출력 매개 변수입니다. 출력 항목 컬렉션에서 제외할 항목을 지정합니다.이 매개 변수에는 와일드카드를 사용할 수 있습니다.자세한 내용은 MSBuild 항목 및 방법: 빌드에서 파일 제외을 참조하십시오. |
Include |
필수적 ITaskItem[] 매개 변수입니다. 출력 항목 컬렉션에 포함할 항목을 지정합니다.이 매개 변수에는 와일드카드를 사용할 수 있습니다. |
PreserveExistingMetadata |
선택적 Boolean 매개 변수입니다. True이면 메타데이터가 이미 존재하지 않는 경우에만 추가 메타데이터를 적용합니다. |
설명
위에 나열된 매개 변수 외에도 이 작업은 Task 클래스에서 상속하는 TaskExtension 클래스의 매개 변수를 상속합니다.추가 매개 변수 목록과 해당 설명은 TaskExtension 기본 클래스를 참조하십시오.
예제
다음 코드 예제에서는 항목 컬렉션 MySourceItems에서 MySourceItemsWithMetadata라는 새 항목 컬렉션을 만듭니다.CreateItem 작업은 새 항목 컬렉션을 MySourceItems 항목에 있는 항목으로 채웁니다.그런 다음 값이 Hello인 MyMetadata라는 추가 메타데이터 엔트리를 새 컬렉션의 각 항목에 추가합니다.
작업을 실행한 후에 MySourceItemsWithMetadata 항목 컬렉션에는 file1.resx와 file2.resx라는 항목이 포함되고, 두 항목에는 모두 MyMetadata에 대한 메타데이터 엔트리가 추가됩니다.MySourceItems 항목 컬렉션은 변경되지 않습니다.
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<MySourceItems Include="file1.resx;file2.resx" />
</ItemGroup>
<Target Name="NewItems">
<CreateItem
Include="@(MySourceItems)"
AdditionalMetadata="MyMetadata=Hello">
<Output
TaskParameter="Include"
ItemName="MySourceItemsWithMetadata"/>
</CreateItem>
</Target>
</Project>
다음 표에서는 작업을 실행한 후의 출력 항목에 대한 값을 보여 줍니다.항목 메타데이터는 항목 뒤에 괄호로 표시되어 있습니다.
항목 컬렉션 |
내용 |
|---|---|
MySourceItemsWithMetadata |
file1.resx (MyMetadata="Hello") file2.resx (MyMetadata="Hello") |