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. 詳細については、「MSBuild 項目」をご覧ください。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 省略可能な ITaskItem[] 型の出力パラメーターです。Optional ITaskItem[] output parameter.

出力項目コレクションから除外する項目を指定します。Specifies the items to exclude from the output item collection. このパラメーターには、ワイルドカードの指定を含めることができます。This parameter can contain wildcard specifications. 詳しくは、「MSBuild 項目」および「方法: ビルドからファイルを除外する」をご覧ください。For more information, see Items and How to: Exclude Files from the Build.
Include 必須の ITaskItem[] パラメーター。Required 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

上記のパラメーター以外に、このタスクは TaskExtension クラスからパラメーターを継承します。このクラス自体は、Task クラスから継承されます。In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the 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. その後、名前が MyMetadata で値が Hello の追加メタデータ エントリを、新しいコレクションの各項目に追加します。It then adds an additional metadata entry named MyMetadata with a value of Hello to each item in the new collection.

タスクを実行した後、MySourceItemsWithMetadata 項目コレクションには項目 file1.resxfile2.resx が含まれ、どちらにも MyMetadata のメタデータ エントリが追加されています。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 (タスク リファレンス) Task Reference
タスクTasks