CreateItem, tâche

Remplit des collections d'éléments avec les éléments d'entrée. Cela permet de copier des éléments d'une liste vers une autre.

Notes

Cette tâche est déconseillée.Si vous démarrez le .NET Framework 3.5, les groupes d'éléments peuvent être placés dans des éléments Target.Pour plus d'informations, consultez Éléments MSBuild.

Attributs

Le tableau suivant décrit les paramètres de la tâche CreateItem.

Paramètre

Description

AdditionalMetadata

Paramètre de tableau String facultatif.

Spécifie les métadonnées supplémentaires à joindre aux éléments de sortie. Indiquez le nom et la valeur des métadonnées de l'élément en respectant la syntaxe suivante :

MetadataName=MetadataValue

Plusieurs paires nom/valeur de métadonnées doivent être séparées par un point-virgule. Si le nom ou la valeur contient un point-virgule ou tout autre caractère spécial, ils doivent être convertis en séquence d'échappement. Pour plus d'informations, consultez Comment : utiliser des caractères spéciaux d'échappement dans MSBuild.

Exclude

Paramètre de sortie ITaskItem[] facultatif.

Spécifie les éléments à exclure de la collection d'éléments de sortie. Ce paramètre peut contenir des spécifications génériques. Pour plus d'informations, consultez Éléments MSBuild et Comment : exclure des fichiers de la build.

Include

Paramètre ITaskItem[] obligatoire.

Spécifie les éléments à inclure dans la collection d'éléments de sortie. Ce paramètre peut contenir des spécifications génériques.

PreserveExistingMetadata

Paramètre Boolean facultatif.

Si la valeur est True, appliquer uniquement les métadonnées supplémentaires si elles n'existent pas déjà.

Notes

En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe TaskExtension, qui hérite elle-même de la classe Task. Pour obtenir la liste de ces paramètres supplémentaires et de leurs descriptions, consultez Classe TaskExtension Base.

Exemple

L'exemple de code suivant crée une nouvelle collection d'éléments appelée MySourceItemsWithMetadata à partir de la collection d'éléments MySourceItems. La tâche CreateItem remplit la nouvelle collection d'éléments avec les éléments de l'élément MySourceItems. Elle ajoute ensuite une entrée de métadonnées supplémentaire appelée MyMetadata avec la valeur Hello à chaque élément de la nouvelle collection.

Après l'exécution de la tâche, 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. La collection d'éléments MySourceItems reste inchangée.

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

Le tableau suivant décrit la valeur de l'élément de sortie après l'exécution de la tâche. Les métadonnées de l'élément sont affichées entre parenthèses après l'élément.

Collection d'éléments

Sommaire

MySourceItemsWithMetadata

file1.resx (MyMetadata="Hello")

file2.resx (MyMetadata="Hello")

Voir aussi

Concepts

Tâches MSBuild

Autres ressources

Référence des tâches MSBuild