Item, élément (MSBuild)

Article
08/10/2011

Contient un élément défini par l'utilisateur et ses métadonnées. Chaque élément utilisé dans un projet MSBuild doit être spécifié en tant qu'enfant d'un élément ItemGroup.

<Item Include="*.cs"
        Exclude="MyFile.cs"
        Remove="RemoveFile.cs"
        Condition="'String A'=='String B'" >
    <ItemMetadata1>...</ItemMetadata1>
    <ItemMetadata2>...</ItemMetadata2>
</Item>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
Include	Attribut requis. Le fichier ou le caractère générique à inclure dans la liste d'éléments.
Exclude	Attribut facultatif. Le fichier ou le caractère générique à exclure de la liste d'éléments.
Remove	Attribut facultatif. Le fichier ou le caractère générique à supprimer de la liste d'éléments. Cet attribut n'est valide que lorsqu'il est spécifié pour un élément dans un ItemGroup de Target.
Condition	Attribut facultatif. Condition à évaluer. Pour plus d'informations, consultez Conditions MSBuild.

Éléments enfants

Élément	Description
ItemMetadata	Clé des métadonnées de l'élément définie par l'utilisateur et contenant la valeur des métadonnées de l'élément. Un élément peut contenir zéro, un ou plusieurs éléments ItemMetadata.

Éléments parents

Élément	Description
ItemGroup	Élément qui regroupe les éléments.

Notes

Les éléments Item définissent des entrées dans le système de génération et sont regroupés en collections d'éléments sur la base de leurs noms de collections définis par l'utilisateur. Ces collections d'éléments peuvent être utilisées comme paramètres des éléments Task qui utilisent les éléments individuels des collections pour exécuter les étapes du processus de génération. Pour plus d'informations, consultez Éléments MSBuild.

L'utilisation de la notation @(myType) permet à une collection d'éléments de type myType d'être développée en liste de chaînes délimitées par des points-virgules (;) et passée à un paramètre. Si le paramètre est de type string, la valeur du paramètre est, dans ce cas, la liste des éléments séparés par des points-virgules. Si le paramètre est un tableau de chaînes (string[]), chaque élément est inséré dans le tableau selon l'emplacement des points-virgules. Si le paramètre de la tâche est de type ITaskItem[], la valeur représente le contenu de la collection d'éléments avec toutes les métadonnées associées. Pour délimiter chaque élément avec un autre caractère que le point-virgule, utilisez la syntaxe @(myType, 'séparateur').

Le moteur MSBuild peut évaluer les caractères génériques tels que * et ?, ainsi que des caractères génériques récursifs comme /**/*.cs. Pour plus d'informations, consultez Éléments MSBuild.

Exemple

L'exemple de code suivant montre comment déclarer deux éléments de type CSFile. Le second élément déclaré contient les métadonnées avec la valeur HelloWorld affectée à myAttribute.

<ItemGroup>
    <CSFile Include="engine.cs; form.cs" />
    <CSFile Include="main.cs" >
        <MyMetadata>HelloWorld</MyMetadata>
    </CSFile>
</ItemGroup>

Voir aussi

Concepts

Éléments MSBuild

Propriétés MSBuild

Référence du schéma de fichier de projet MSBuild

Partager via