Partager via


Éléments MSBuild

Les éléments MSBuild sont des entrées du système de génération qui représentent généralement des fichiers (spécifiés dans l’attribut Include). Les éléments sont regroupés en différents types selon leurs noms d’élément. Les types d’élément sont des listes nommées d’éléments qui peuvent être utilisés comme paramètres pour les tâches. Les tâches utilisent les valeurs d’élément pour exécuter les étapes du processus de génération.

Comme les éléments sont nommés en fonction du type d’élément dont ils font partie, les termes « élément » et « valeur d’élément » peuvent être utilisés indifféremment.

Créer des éléments dans un fichier projet

Vous déclarez des éléments dans le fichier projet en tant qu’éléments enfants d’un élément ItemGroup. Les noms d’éléments valides commencent par une lettre majuscule ou minuscule ou un trait de soulignement (_). Les caractères suivants valides incluent des caractères alphanumériques (lettres ou chiffres), un trait de soulignement et un trait d’union (-). Le nom de l’élément enfant est le type de l’élément. L’attribut Include de l’élément spécifie les éléments (fichiers) à inclure avec ce type d’élément. Par exemple, le code XML suivant crée un type d’élément nommé Compile et composé de deux fichiers.

<ItemGroup>
    <Compile Include = "file1.cs"/>
    <Compile Include = "file2.cs"/>
</ItemGroup>

L’élément file2.cs ne remplace pas l’élément file1.cs. Le nom de fichier est ajouté à la liste des valeurs correspondant au type d’élément Compile.

Le code XML suivant crée le même type d’élément en déclarant les deux fichiers dans un attribut Include. Notez que les noms de fichiers sont séparés par un point-virgule.

<ItemGroup>
    <Compile Include = "file1.cs;file2.cs"/>
</ItemGroup>

L’attribut Include est un chemin interprété par rapport au dossier du fichier de projet, $(MSBuildProjectPath), même si l’élément se trouve dans un fichier importé, par exemple un fichier .targets.

Créer des éléments lors de l’exécution

Des valeurs sont attribuées aux éléments situés en dehors des éléments Target pendant la phase d’évaluation d’une génération. Pendant la phase d’exécution suivante, des éléments peuvent être créés ou modifiés en procédant comme suit :

  • Une tâche peut émettre un élément. Pour émettre un élément, l’élément Task doit posséder un élément Output enfant pourvu d’un attribut ItemName.

  • La tâche CreateItem peut émettre un élément. Cette utilisation est dépréciée.

  • Les éléments Target peuvent contenir des éléments ItemGroup qui peuvent comporter des éléments Item.

Référencer des éléments dans un fichier projet

Pour référencer des types d’éléments dans tout le fichier projet, vous devez utiliser la syntaxe @(ItemType). Par exemple, vous devez référencer le type d’élément dans l’exemple précédent en utilisant @(Compile). À l’aide de cette syntaxe, vous pouvez transmettre des éléments aux tâches en spécifiant le type d’élément en tant que paramètre de la tâche en question. Pour plus d’informations, consultez Guide pratique pour sélectionner des fichiers dans une build.

Par défaut, les éléments d’un type d’élément développé sont séparés par des points-virgules (;). Vous pouvez utiliser la syntaxe @(ItemType, 'separator') pour spécifier un séparateur autre que celui indiqué par défaut. Pour plus d’informations, consultez Guide pratique pour afficher une liste d’éléments séparés par des virgules.

Utiliser des caractères génériques pour spécifier des éléments

Vous pouvez utiliser les caractères génériques **, * et ? pour spécifier un groupe de fichiers comme entrées d’une génération au lieu de répertorier chaque fichier séparément.

  • Le caractère générique ? correspond à un caractère unique.
  • Le caractère générique * correspond à zéro ou plusieurs caractères.
  • La séquence de caractères génériques ** correspond à un chemin d’accès partiel.

Par exemple, vous pouvez spécifier tous les fichiers .cs du répertoire qui contient le fichier projet à l’aide de l’élément ci-dessous contenu dans votre fichier projet.

<CSFile Include="*.cs"/>

L’élément suivant permet de sélectionner tous les fichiers .vb sur le lecteur D: :

<VBFile Include="D:/**/*.vb"/>

Si vous souhaitez inclure des caractères * ou ? littéraux dans un élément sans le développement des caractères génériques, vous devez utiliser des caractères génériques d’échappement.

Pour plus d’informations sur les caractères génériques, consultez Guide pratique pour sélectionner des fichiers dans une build.

Utiliser l’attribut Exclude

Les éléments Item peuvent contenir l’attribut Exclude qui exclut des éléments spécifiques (fichiers) du type d’élément. L’attribut Exclude est généralement utilisé avec des caractères génériques. Par exemple, le code XML suivant ajoute tous les fichiers .cs du répertoire au type d’élément CSFile, à l’exception du fichier DoNotBuild.cs.

<ItemGroup>
    <CSFile  Include="*.cs"  Exclude="DoNotBuild.cs"/>
</ItemGroup>

L’attribut Exclude affecte uniquement les éléments qui sont ajoutés par l’attribut Include dans l’élément Item qui les contient. Dans l’exemple suivant, le fichier Form1.cs, qui a été ajouté dans l’élément Item précédent n’est pas exclu.

<Compile Include="*.cs" />
<Compile Include="*.res" Exclude="Form1.cs">

Pour plus d’informations, consultez Guide pratique pour exclure des fichiers de la build.

Métadonnées d’élément

Outre les informations des attributs Include et Exclude, les éléments peuvent contenir des métadonnées. Ces métadonnées peuvent être utilisées par les tâches qui requièrent plus d’informations sur les éléments ou pour traiter par lot les tâches et les cibles. Pour plus d’informations, consultez l’article Batching (Traitement par lot MSBuild).

Les métadonnées sont une collection de paires clé-valeur qui sont déclarées dans le fichier projet en tant qu’éléments enfants d’un élément Item. Le nom et la valeur de l’élément enfant correspondent au nom et à la valeur de la métadonnée.

La métadonnée est associée à l’élément Item qui le contient. Par exemple, le code XML suivant ajoute les métadonnées Culture qui ont la valeur Fr aux éléments one.cs et two.cs du type d’élément CSFile.

<ItemGroup>
    <CSFile Include="one.cs;two.cs">
        <Culture>Fr</Culture>
    </CSFile>
</ItemGroup>

Un élément peut comporter zéro ou plusieurs valeurs de métadonnées. Vous pouvez modifier des valeurs de métadonnées à tout moment. Si vous définissez une métadonnée sur une valeur vide, vous la supprimez de la génération.

Référencer des métadonnées d’élément dans un fichier projet

Vous pouvez référencer des métadonnées d’élément dans tout le fichier projet à l’aide de la syntaxe %(ItemMetadataName). En cas d’ambiguïté, vous pouvez qualifier une référence à l’aide du nom du type d’élément. Par exemple, vous pouvez spécifier %(ItemType.ItemMetaDataName). L’exemple suivant utilise les métadonnées Display pour traiter la tâche Message. Pour plus d’informations sur l’utilisation des métadonnées d’élément pour le traitement par lots, consultez Métadonnées d’élément dans le traitement par lots des tâches.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <Stuff Include="One.cs" >
            <Display>false</Display>
        </Stuff>
        <Stuff Include="Two.cs">
            <Display>true</Display>
        </Stuff>
    </ItemGroup>
    <Target Name="Batching">
        <Message Text="@(Stuff)" Condition=" '%(Display)' == 'true' "/>
    </Target>
</Project>

Métadonnées d'éléments connus

Lorsqu’un élément est ajouté à un type d’élément, des métadonnées connues lui sont attribuées. Par exemple, tous les éléments possèdent les métadonnées connues %(Filename), dont la valeur correspond au nom de fichier de l’élément (sans l’extension). Pour plus d’informations, consultez Métadonnées d’élément connues.

Transformer des types d’éléments à l’aide de métadonnées

Vous pouvez transformer des listes d’éléments en nouvelles listes d’éléments à l’aide de métadonnées. Par exemple, vous pouvez transformer un type d’élément CppFiles qui contient des éléments représentant des fichiers .cpp en une liste correspondante de fichiers .obj à l’aide de l’expression @(CppFiles -> '%(Filename).obj').

Le code suivant crée un type d’élément CultureResource qui contient des copies de tous les éléments EmbeddedResource comportant la métadonnée Culture. La valeur de la métadonnée Culture devient la valeur de la nouvelle métadonnée CultureResource.TargetDirectory.

<Target Name="ProcessCultureResources">
    <ItemGroup>
        <CultureResource Include="@(EmbeddedResource)"
            Condition="'%(EmbeddedResource.Culture)' != ''">
            <TargetDirectory>%(EmbeddedResource.Culture) </TargetDirectory>
        </CultureResource>
    </ItemGroup>
</Target>

Pour plus d'opérations sur les éléments, voir Fonctions d’élément MSBuild et Transformations.

Définitions d’éléments

Vous pouvez ajouter des métadonnées par défaut à tout type d’élément à l’aide de l’élément ItemDefinitionGroup. À l’instar des métadonnées connues, les métadonnées par défaut sont associées à tous les éléments du type d’élément que vous spécifiez. Vous pouvez remplacer les métadonnées par défaut dans une définition d’élément de façon explicite. Par exemple, le code XML suivant fournit aux éléments Compileone.cs et three.cs les métadonnées BuildDay pourvues de la valeur « Monday ». Le code donne à l’élément two.cs les métadonnées BuildDay pourvues de la valeur « Tuesday ».

<ItemDefinitionGroup>
    <Compile>
        <BuildDay>Monday</BuildDay>
    </Compile>
</ItemDefinitionGroup>
<ItemGroup>
    <Compile Include="one.cs;three.cs" />
    <Compile Include="two.cs">
        <BuildDay>Tuesday</BuildDay>
    </Compile>
</ItemGroup>

Pour plus d’informations, consultez Définitions d’éléments.

Attributs des éléments d’un ItemGroup d’une cible

Les éléments Target peuvent contenir des éléments ItemGroup qui peuvent comporter des éléments Item. Les attributs de cette section sont valides s’ils sont spécifiés pour un élément d’un ItemGroup qui se trouve dans une Target.

Supprimer l’attribut

L’attribut Remove supprime des éléments spécifiques (fichiers) du type d’élément. Cet attribut a été introduit dans .NET Framework 3.5) (à l’intérieur de cibles uniquement). Les cibles internes et externes sont prises en charge à partir de MSBuild 15.0.

Dans l’exemple suivant, tous les fichiers .config sont supprimés du type d’élément Compile.

<Target>
    <ItemGroup>
        <Compile Remove="*.config"/>
    </ItemGroup>
</Target>

Attribut MatchOnMetadata

L’attribut MatchOnMetadata ne s’applique qu’aux attributs Remove qui font référence à d’autres éléments (par exemple, Remove="@(Compile);@(Content)") et indique à l’opération Remove de faire correspondre les éléments sur la base des valeurs des noms de métadonnées spécifiés, au lieu de les faire correspondre sur la base des valeurs de l’élément.

Règle de correspondance pour B Remove="@(A)" MatchOnMetadata="M" : supprimer tous les éléments de B qui ont des métadonnées M, dont la valeur de métadonnées V pour M correspond à tout élément de A avec des métadonnées M de valeur V.

<Project>
  <ItemGroup>
    <A Include='a1' M1='1' M2='a' M3="e"/>
    <A Include='b1' M1='2' M2='x' M3="f"/>
    <A Include='c1' M1='3' M2='y' M3="g"/>
    <A Include='d1' M1='4' M2='b' M3="h"/>

    <B Include='a2' M1='x' m2='c' M3="m"/>
    <B Include='b2' M1='2' m2='x' M3="n"/>
    <B Include='c2' M1='2' m2='x' M3="o"/>
    <B Include='d2' M1='3' m2='y' M3="p"/>
    <B Include='e2' M1='3' m2='Y' M3="p"/>
    <B Include='f2' M1='4'        M3="r"/>
    <B Include='g2'               M3="s"/>

    <B Remove='@(A)' MatchOnMetadata='M1;M2'/>
  </ItemGroup>

  <Target Name="PrintEvaluation">
    <Message Text="%(B.Identity) M1='%(B.M1)' M2='%(B.M2)' M3='%(B.M3)'" />
  </Target>
</Project>

Dans l’exemple, les valeurs de l’élément b2, c2, et d2 sont supprimées de l’élément B car :

  • b2 et c2 de B correspondent à b1 de A sur M1=2 et M2=x
  • d2 de B correspondent à c1 de A sur M1=3 et M2=y

La tâche Message génère les résultats suivants :

  a2 M1='x' M2='c' M3='m'
  e2 M1='3' M2='Y' M3='p'
  f2 M1='4' M2='' M3='r'
  g2 M1='' M2='' M3='s'

Exemple d’utilisation de MatchOnMetadata à partir de MSBuild :

      <_TransitiveItemsToCopyToOutputDirectory Remove="@(_ThisProjectItemsToCopyToOutputDirectory)" MatchOnMetadata="TargetPath" MatchOnMetadataOptions="PathLike" />

La ligne supprime les éléments de _TransitiveItemsToCopyToOutputDirectory qui ont les mêmes valeurs de métadonnées TargetPath des éléments dans _ThisProjectItemsToCopyToOutputDirectory

Attribut MatchOnMetadataOptions

Spécifie la stratégie de correspondance de chaîne utilisée par MatchOnMetadata pour la correspondance des valeurs de métadonnées entre les éléments (les noms de métadonnées ne respectent jamais la casse). Les valeurs possibles sont CaseSensitive, CaseInsensitive ou PathLike. La valeur par défaut est CaseSensitive.

PathLike applique la normalisation des chemins d’accès aux valeurs telles que la normalisation des orientations de barre oblique, en ignorant les barres obliques de fin, en supprimant . et .., et en rendant tous les chemins relatifs absolus dans le répertoire actif.

Attribut KeepMetadata

Si un élément est généré au sein d’une cible, l’élément Item peut contenir l’attribut KeepMetadata. Si cet attribut est spécifié, seules les métadonnées qui sont spécifiées dans la liste de noms séparés par des points-virgules sont transférées de l’élément source à l’élément cible. Pour cet attribut, utiliser une valeur vide revient à ne pas le spécifier. L’attribut KeepMetadata a été introduit dans .NET Framework 4.5.

L’exemple suivant montre comment utiliser l’attribut KeepMetadata.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003"
ToolsVersion="4.0">

    <ItemGroup>
        <FirstItem Include="rhinoceros">
            <Class>mammal</Class>
            <Size>large</Size>
        </FirstItem>

    </ItemGroup>
    <Target Name="MyTarget">
        <ItemGroup>
            <SecondItem Include="@(FirstItem)" KeepMetadata="Class" />
        </ItemGroup>

        <Message Text="FirstItem: %(FirstItem.Identity)" />
        <Message Text="  Class: %(FirstItem.Class)" />
        <Message Text="  Size:  %(FirstItem.Size)"  />

        <Message Text="SecondItem: %(SecondItem.Identity)" />
        <Message Text="  Class: %(SecondItem.Class)" />
        <Message Text="  Size:  %(SecondItem.Size)"  />
    </Target>
</Project>

<!--
Output:
  FirstItem: rhinoceros
    Class: mammal
    Size:  large
  SecondItem: rhinoceros
    Class: mammal
    Size:
-->

Attribut RemoveMetadata

Si un élément est généré au sein d’une cible, l’élément Item peut contenir l’attribut RemoveMetadata. Si cet attribut est spécifié, toutes les métadonnées sont transférées de l’élément source vers l’élément cible, à l’exception des métadonnées dont les noms figurent dans la liste de noms séparés par des points-virgules. Pour cet attribut, utiliser une valeur vide revient à ne pas le spécifier. L’attribut RemoveMetadata a été introduit dans .NET Framework 4.5.

L’exemple suivant montre comment utiliser l’attribut RemoveMetadata.

<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <PropertyGroup>
        <MetadataToRemove>Size;Material</MetadataToRemove>
    </PropertyGroup>

    <ItemGroup>
        <Item1 Include="stapler">
            <Size>medium</Size>
            <Color>black</Color>
            <Material>plastic</Material>
        </Item1>
    </ItemGroup>

    <Target Name="MyTarget">
        <ItemGroup>
            <Item2 Include="@(Item1)" RemoveMetadata="$(MetadataToRemove)" />
        </ItemGroup>

        <Message Text="Item1: %(Item1.Identity)" />
        <Message Text="  Size:     %(Item1.Size)" />
        <Message Text="  Color:    %(Item1.Color)" />
        <Message Text="  Material: %(Item1.Material)" />
        <Message Text="Item2: %(Item2.Identity)" />
        <Message Text="  Size:     %(Item2.Size)" />
        <Message Text="  Color:    %(Item2.Color)" />
        <Message Text="  Material: %(Item2.Material)" />
    </Target>
</Project>

<!--
Output:
  Item1: stapler
    Size:     medium
    Color:    black
    Material: plastic
  Item2: stapler
    Size:
    Color:    black
    Material:
-->

Pour plus d'opérations sur les éléments, voir Fonctions d’élément MSBuild.

Attribut KeepDuplicates

Si un élément est généré au sein d’une cible, l’élément Item peut contenir l’attribut KeepDuplicates. KeepDuplicates est un attribut Boolean qui spécifie si un élément doit être ajouté au groupe cible si l’élément est une copie exacte d’un élément existant.

Si les éléments source et cible ont les mêmes valeurs Include mais des métadonnées différentes, l'élément est ajouté même si KeepDuplicates est défini sur false. Pour cet attribut, utiliser une valeur vide revient à ne pas le spécifier. L’attribut KeepDuplicates a été introduit dans .NET Framework 4.5.

L’exemple suivant montre comment utiliser l’attribut KeepDuplicates.

<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>
        <Item1 Include="hourglass;boomerang" />
        <Item2 Include="hourglass;boomerang" />
    </ItemGroup>

    <Target Name="MyTarget">
        <ItemGroup>
            <Item1 Include="hourglass" KeepDuplicates="false" />
            <Item2 Include="hourglass" />
        </ItemGroup>

        <Message Text="Item1: @(Item1)" />
        <Message Text="  %(Item1.Identity)  Count: @(Item1->Count())" />
        <Message Text="Item2: @(Item2)" />
        <Message Text="  %(Item2.Identity)  Count: @(Item2->Count())" />
    </Target>
</Project>

<!--
Output:
  Item1: hourglass;boomerang
    hourglass  Count: 1
    boomerang  Count: 1
  Item2: hourglass;boomerang;hourglass
    hourglass  Count: 2
    boomerang  Count: 1
-->

Étant donné que l’attribut KeepDuplicates considère les métadonnées des éléments en plus des valeurs d’élément, il est important de savoir ce qui se passe avec les métadonnées. Par exemple, consultez Détection des doublons lors de l’utilisation de la fonction d’élément Metadata.

Mise à jour des métadonnées sur les éléments d'un ItemGroup à l’extérieur d'une cible

Les métadonnées existantes d’éléments en dehors de cibles peuvent être mises à jour via l’attribut Update. Cet attribut n’est pas disponible pour les éléments sous cibles.

<Project>
    <PropertyGroup>
        <MetadataToUpdate>pencil</MetadataToUpdate>
    </PropertyGroup>

    <ItemGroup>
        <Item1 Include="stapler">
            <Size>medium</Size>
            <Color>black</Color>
            <Material>plastic</Material>
        </Item1>
        <Item1 Include="pencil">
            <Size>small</Size>
            <Color>yellow</Color>
            <Material>wood</Material>
        </Item1>
        <Item1 Include="eraser">
            <Color>red</Color>
        </Item1>
        <Item1 Include="notebook">
            <Size>large</Size>
            <Color>white</Color>
            <Material>paper</Material>
        </Item1>

        <Item2 Include="notebook">
            <Size>SMALL</Size>
            <Color>YELLOW</Color>
        </Item2>

        <!-- Metadata can be expressed either as attributes or as elements -->
        <Item1 Update="$(MetadataToUpdate);stapler;er*r;@(Item2)" Price="10" Material="">
            <Color>RED</Color>
        </Item1>
    </ItemGroup>

    <Target Name="MyTarget">
        <Message Text="Item1: %(Item1.Identity)
    Size: %(Item1.Size)
    Color: %(Item1.Color)
    Material: %(Item1.Material)
    Price: %(Item1.Price)" />
    </Target>
</Project>

<!--  
Item1: stapler
    Size: medium
    Color: RED
    Material:
    Price: 10
Item1: pencil
    Size: small
    Color: RED
    Material:
    Price: 10
Item1: eraser
    Size:
    Color: RED
    Material:
    Price: 10
Item1: notebook
    Size: large
    Color: RED
    Material:
    Price: 10
-->

Dans MSBuild version 16.6 et ultérieure, l’attribut Update prend en charge les références de métadonnées qualifiées pour faciliter l’importation de métadonnées à partir de deux éléments ou plus.

<Project>
    <ItemGroup>
        <Item1 Include="stapler">
            <Size>medium</Size>
            <Color>black</Color>
            <Material>plastic</Material>
        </Item1>
        <Item1 Include="pencil">
            <Size>small</Size>
            <Color>yellow</Color>
            <Material>wood</Material>
        </Item1>
        <Item1 Include="eraser">
            <Size>small</Size>
            <Color>red</Color>
            <Material>gum</Material>
        </Item1>
        <Item1 Include="notebook">
            <Size>large</Size>
            <Color>white</Color>
            <Material>paper</Material>
        </Item1>

        <Item2 Include="pencil">
            <Size>MEDIUM</Size>
            <Color>RED</Color>
            <Material>PLASTIC</Material>
            <Price>10</Price>
        </Item2>

        <Item3 Include="notebook">
            <Size>SMALL</Size>
            <Color>BLUE</Color>
            <Price>20</Price>
        </Item3>

        <!-- Metadata can be expressed either as attributes or as elements -->
        <Item1 Update="@(Item2);er*r;@(Item3)" Size="%(Size)" Color="%(Item2.Color)" Price="%(Item3.Price)" Model="2020">
            <Material Condition="'%(Item2.Material)' != ''">Premium %(Item2.Material)</Material>
        </Item1>
    </ItemGroup>

    <Target Name="MyTarget">
        <Message Text="Item1: %(Item1.Identity)
    Size: %(Item1.Size)
    Color: %(Item1.Color)
    Material: %(Item1.Material)
    Price: %(Item1.Price)
    Model: %(Item1.Model)" />
    </Target>
</Project>

<!--  
Item1: stapler
    Size: medium
    Color: black
    Material: plastic
    Price:
    Model:
Item1: pencil
    Size: small
    Color: RED
    Material: Premium PLASTIC
    Price:
    Model: 2020
Item1: eraser
    Size: small
    Color:
    Material: gum
    Price:
    Model: 2020
Item1: notebook
    Size: large
    Color:
    Material: paper
    Price: 20
    Model: 2020
-->

Remarques :

  • Les métadonnées non qualifiées (%(MetadataName)) sont liées au type d’élément mis à jour (Item1 dans l’exemple ci-dessus). Les métadonnées qualifiées (%(Item2.Color)) se lient à l'intérieur de l'ensemble des types d'éléments capturés correspondant de l'expression de mise à jour.
  • Si un élément correspond plusieurs fois dans et entre plusieurs éléments référencés :
    • La dernière occurrence de chaque type d’élément référencé est capturée (par conséquent, un élément capturé par type d’élément).
    • Cela correspond au comportement du traitement par lots d’éléments de tâche sous cibles.
  • Où l’on peut placer des références %() :
    • Métadonnées
    • Conditions de métadonnées
  • La correspondance des noms de métadonnées ne respecte pas la casse.

Mise à jour des métadonnées sur les éléments d'un ItemGroup d'une cible

Les métadonnées peuvent également être modifiées à l'intérieur des cibles, au moyen d'une syntaxe moins expressive que celle de Update :

<Project>
    <ItemGroup>
        <Item1 Include="stapler">
            <Size>medium</Size>
            <Color>black</Color>
            <Material>plastic</Material>
        </Item1>
        <Item1 Include="pencil">
            <Size>small</Size>
            <Color>yellow</Color>
            <Material>wood</Material>
        </Item1>
        <Item1 Include="eraser">
            <Size>small</Size>
            <Color>red</Color>
            <Material>gum</Material>
        </Item1>
        <Item1 Include="notebook">
            <Size>large</Size>
            <Color>white</Color>
            <Material>paper</Material>
        </Item1>

        <Item2 Include="pencil">
            <Size>MEDIUM</Size>
            <Color>RED</Color>
            <Material>PLASTIC</Material>
            <Price>10</Price>
        </Item2>

        <Item2 Include="ruler">
            <Color>GREEN</Color>
        </Item2>

    </ItemGroup>

    <Target Name="MyTarget">
        <ItemGroup>
            <!-- Metadata can be expressed either as attributes or as elements -->
            <Item1 Size="GIGANTIC" Color="%(Item2.Color)">
                <Material Condition="'%(Item2.Material)' != ''">Premium %(Item2.Material)</Material>
            </Item1>
        </ItemGroup>

        <Message Text="Item1: %(Item1.Identity)
    Size: %(Item1.Size)
    Color: %(Item1.Color)
    Material: %(Item1.Material)
    Price: %(Item1.Price)
    Model: %(Item1.Model)" />
    </Target>
</Project>

<!--  
Item1: stapler
    Size: GIGANTIC
    Color: GREEN
    Material: Premium PLASTIC
    Price:
    Model:
Item1: pencil
    Size: GIGANTIC
    Color: GREEN
    Material: Premium PLASTIC
    Price:
    Model:
Item1: eraser
    Size: GIGANTIC
    Color: GREEN
    Material: Premium PLASTIC
    Price:
    Model:
Item1: notebook
    Size: GIGANTIC
    Color: GREEN
    Material: Premium PLASTIC
    Price:
    Model:
-->