CreateItem 작업CreateItem Task

항목 컬렉션을 입력 항목으로 채웁니다.Populates item collections with the input items. 이를 통해 한 목록의 항목을 다른 목록으로 복사할 수 있습니다.This allows items to be copied from one list to another.

참고

이 작업은 더 이상 사용되지 않습니다.This task is deprecated. .NET Framework 3.5부터 항목 그룹은 Target 요소 내에 배치될 수 있습니다.Starting with .NET Framework 3.5, item groups may be placed within Target elements. 자세한 내용은 항목을 참조하세요.For more information, see Items.

특성Attributes

다음 표에서는 CreateItem 작업의 매개 변수에 대해 설명합니다.The following table describes the parameters of the CreateItem task.

매개 변수Parameter 설명Description
AdditionalMetadata 선택적 String 배열 매개 변수입니다.Optional String array parameter.

출력 항목에 연결할 추가 메타데이터를 지정합니다.Specifies additional metadata to attach to the output items. 다음 구문을 사용하여 항목의 메타데이터 이름 및 값을 지정합니다.Specify the metadata name and value for the item with the following syntax:

MetadataName = MetadataValueMetadataName = MetadataValue

여러 메타데이터 이름/값 쌍은 세미콜론으로 구분해야 합니다.Multiple metadata name/value pairs should be separated with a semicolon. 이름 또는 값에 세미콜론이나 기타 특수 문자가 포함되는 경우 이스케이프되어야 합니다.If either the name or the value contains a semicolon or any other special characters, they must be escaped. 자세한 내용은 방법: MSBuild의 이스케이프 특수 문자를 참조하세요.For more information, see How to: Escape Special Characters in MSBuild.
Exclude 선택적 <xref:Microsoft.Build.Framework.ITaskItem>[] 출력 매개 변수입니다.Optional <xref:Microsoft.Build.Framework.ITaskItem>[] output parameter.

출력 항목 컬렉션에서 제외할 항목을 지정합니다.Specifies the items to exclude from the output item collection. 이 매개 변수는 와일드카드 지정을 포함할 수 있습니다.This parameter can contain wildcard specifications. 자세한 내용은 항목방법: 빌드에서 파일 제외를 참조하세요.For more information, see Items and How to: Exclude Files from the Build.
Include 필수 <xref:Microsoft.Build.Framework.ITaskItem>[] 매개 변수Required <xref:Microsoft.Build.Framework.ITaskItem>[]parameter.

출력 항목 컬렉션에 포함할 항목을 지정합니다.Specifies the items to include in the output item collection. 이 매개 변수는 와일드카드 지정을 포함할 수 있습니다.This parameter can contain wildcard specifications.
PreserveExistingMetadata 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

True인 경우 추가 메타데이터만 적용합니다(아직 존재하지 않을 경우).If True, only apply the additional metadata if they do not already exist.

설명Remarks

이 작업은 위에 나와 있는 매개 변수 외에 <xref:Microsoft.Build.Utilities.Task> 클래스에서 직접 상속하는 <xref:Microsoft.Build.Tasks.TaskExtension> 클래스의 매개 변수도 상속합니다.In addition to the parameters listed above, this task inherits parameters from the <xref:Microsoft.Build.Tasks.TaskExtension> class, which itself inherits from the <xref:Microsoft.Build.Utilities.Task> class. 이러한 추가 매개 변수 및 해당 설명이 포함된 목록은 TaskExtension Base Class를 참조하세요.For a list of these additional parameters and their descriptions, see TaskExtension Base Class.

Example

다음 코드 예제에서는 항목 컬렉션 MySourceItems에서 MySourceItemsWithMetadata라는 새 항목 컬렉션을 만듭니다.The following code example creates a new item collection named MySourceItemsWithMetadata from the item collection MySourceItems. CreateItem 작업은 MySourceItems 항목에 있는 항목으로 새 항목 컬렉션을 채웁니다.The CreateItem task populates the new item collection with the items in the MySourceItems item. 그런 다음 값이 HelloMyMetadata라는 추가 메타데이터 항목을 새 컬렉션의 각 항목에 추가합니다.It then adds an additional metadata entry named MyMetadata with a value of Hello to each item in the new collection.

작업이 실행된 후 MySourceItemsWithMetadata 항목 컬렉션에는 MyMetadata에 대한 메타데이터 항목을 포함하는 file1.resxfile2.resx 항목이 포함됩니다.After the task is executed, the MySourceItemsWithMetadata item collection contains the items file1.resx and file2.resx, both with metadata entries for MyMetadata. MySourceItems 항목 컬렉션은 변경되지 않습니다.The MySourceItems item collection is unchanged.

<Project xmlns="http://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>  

다음 표에서는 작업 실행 이후의 출력 항목 값을 설명합니다.The following table describes the value of the output item after task execution. 항목 뒤에 괄호로 묶은 내용이 항목 메타데이터입니다.Item metadata is shown in parenthesis after the item.

항목 컬렉션입니다.Item collection 목차Contents
MySourceItemsWithMetadata file1.resx (MyMetadata="Hello")file1.resx (MyMetadata="Hello")

file2.resx (MyMetadata="Hello")file2.resx (MyMetadata="Hello")

참고 항목See Also

작업 참조 Task Reference
작업Tasks