Item, élément (MSBuild)

Article
08/21/2008

Mise à jour : novembre 2007

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"
        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. Fichier ou caractère générique à inclure dans l'élément.
Exclude	Attribut facultatif. Fichier ou caractère générique à exclure de l'élément.
Condition	Attribut facultatif. Condition à évaluer. Pour plus d'informations, consultez Conditions MSBuild.

Include

Attribut requis.

Fichier ou caractère générique à inclure dans l'élément.

Exclude

Attribut facultatif.

Fichier ou caractère générique à exclure de l'élément.

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 aucun 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 de la collection 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 est capable d'évaluer des 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>
    </Item>
</ItemGroup>

Voir aussi

Concepts

Éléments MSBuild

Propriétés MSBuild

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

Share via