Partager via


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 à une autre.

Notes

Cette tâche est dépréciée. À compter du .NET Framework 3.5, les groupes d’éléments peuvent être placés dans des éléments Target. Pour plus d’informations, consultez l’article Éléments MSBuild.

Attributs

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

Paramètre Description
AdditionalMetadata Paramètres de tableau String facultatif.

Spécifie des métadonnées supplémentaires à attacher aux éléments de sortie. Spécifiez le nom et la valeur des métadonnées de l’élément avec 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 échappés. Pour plus d’informations, consultez Guide pratique pour 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 de caractères génériques. Pour plus d’informations, consultez Éléments et Guide pratique pour 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 de caractères génériques.
PreserveExistingMetadata Paramètre Boolean facultatif.

Si True, appliquer uniquement les métadonnées supplémentaires si elles n’existent pas.

Notes

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 . Pour obtenir la liste de ces paramètres supplémentaires et leurs descriptions, consultez Classe de base TaskExtension.

Exemple

L’exemple de code suivant crée une collection d’éléments nommé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 contenus dans l’élément MySourceItems. 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.

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. La collection d’éléments MySourceItems est inchangée.

<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. Les métadonnées d’élément sont affichées entre parenthèses après l’élément.

Collection d'éléments. Contenu
MySourceItemsWithMetadata file1.resx (MyMetadata="Hello")

file2.resx (MyMetadata="Hello")

Voir aussi