CreateItem, tâcheCreateItem Task

11/04/2016
3 minutes de lecture
Contributeurs

Remplit des collections d’éléments avec les éléments d’entrée.Populates item collections with the input items. Cela permet de copier des éléments d’une liste à une autre.This allows items to be copied from one list to another.

Note

Cette tâche est dépréciée.This task is deprecated. À compter du .NET Framework 3.5, les groupes d’éléments peuvent être placés dans des éléments Target.Starting with .NET Framework 3.5, item groups may be placed within Target elements. Pour plus d’informations, consultez l’article Éléments MSBuild.For more information, see Items.

AttributsAttributes

Le tableau ci-dessous décrit les paramètres de la tâche CreateItem .The following table describes the parameters of the CreateItem task.

ParamètreParameter	DescriptionDescription
`AdditionalMetadata`	Paramètres de tableau `String` facultatif.Optional `String` array parameter. Spécifie des métadonnées supplémentaires à attacher aux éléments de sortie.Specifies additional metadata to attach to the output items. Spécifiez le nom et la valeur des métadonnées de l’élément avec la syntaxe suivante :Specify the metadata name and value for the item with the following syntax: nom_métadonnées `=` valeur_métadonnéesMetadataName `=` MetadataValue Plusieurs paires nom/valeur de métadonnées doivent être séparées par un point-virgule.Multiple metadata name/value pairs should be separated with a semicolon. Si le nom ou la valeur contient un point-virgule ou tout autre caractère spécial, ils doivent être échappés.If either the name or the value contains a semicolon or any other special characters, they must be escaped. Pour plus d’informations, consultez Guide pratique pour utiliser des caractères spéciaux d’échappement dans MSBuild.For more information, see How to: Escape Special Characters in MSBuild.
`Exclude`	Paramètre de sortie ITaskItem`[]` facultatif.Optional ITaskItem`[]` output parameter. Spécifie les éléments à exclure de la collection d’éléments de sortie.Specifies the items to exclude from the output item collection. Ce paramètre peut contenir des spécifications de caractères génériques.This parameter can contain wildcard specifications. Pour plus d’informations, consultez Éléments et Guide pratique pour exclure des fichiers de la build.For more information, see Items and How to: Exclude Files from the Build.
`Include`	Paramètre ITaskItem`[]` obligatoire.Required ITaskItem`[]`parameter. Spécifie les éléments à inclure dans la collection d’éléments de sortie.Specifies the items to include in the output item collection. Ce paramètre peut contenir des spécifications de caractères génériques.This parameter can contain wildcard specifications.
`PreserveExistingMetadata`	Paramètre `Boolean` facultatif.Optional `Boolean` parameter. Si `True`, appliquer uniquement les métadonnées supplémentaires si elles n’existent pas.If `True`, only apply the additional metadata if they do not already exist.

NotesRemarks

En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe TaskExtension, qui elle-même hérite de la classe Task.In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the Task class. Pour obtenir la liste de ces paramètres supplémentaires et leurs descriptions, consultez TaskExtension Base Class.For a list of these additional parameters and their descriptions, see TaskExtension Base Class.

ExempleExample

L’exemple de code suivant crée une collection d’éléments nommée MySourceItemsWithMetadata à partir de la collection d’éléments MySourceItems.The following code example creates a new item collection named MySourceItemsWithMetadata from the item collection MySourceItems. La tâche CreateItem remplit la nouvelle collection d’éléments avec les éléments contenus dans l’élément MySourceItems.The CreateItem task populates the new item collection with the items in the MySourceItems item. Elle ajoute ensuite une entrée de métadonnées supplémentaire nommée MyMetadata avec la valeur Hello à chaque élément de la nouvelle collection.It then adds an additional metadata entry named MyMetadata with a value of Hello to each item in the new collection.

Une fois la tâche exécutée, la collection d’éléments MySourceItemsWithMetadata contient les éléments file1.resx et file2.resx, tous deux avec des entrées de métadonnées pour MyMetadata.After the task is executed, the MySourceItemsWithMetadata item collection contains the items file1.resx and file2.resx, both with metadata entries for MyMetadata. La collection d’éléments MySourceItems est inchangée.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>

Le tableau suivant décrit la valeur de l’élément de sortie après l’exécution de la tâche.The following table describes the value of the output item after task execution. Les métadonnées de l’élément sont affichées entre parenthèses après l’élément.Item metadata is shown in parenthesis after the item.

Collection d'éléments.Item collection	SommaireContents
`MySourceItemsWithMetadata`	`file1.resx` (`MyMetadata="Hello"`)`file1.resx` (`MyMetadata="Hello"`) `file2.resx` (`MyMetadata="Hello"`)`file2.resx` (`MyMetadata="Hello"`)

Voir aussiSee Also

Task Reference (Informations de référence sur les tâches MSBuild) Task Reference
TâchesTasks