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")

참고 항목

개념

MSBuild 작업

기타 리소스

MSBuild 작업 참조