CreateItem Task

 

Pour obtenir la dernière documentation sur Visual Studio 2017 RC, consultez Documentation Visual Studio 2017 RC.

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.

System_CAPS_ICON_note.jpg Remarque

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

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

ParamètreDescription
AdditionalMetadataParamè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 How to: Escape Special Characters in MSBuild.
ExcludeParamè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 Items et How to: Exclude Files from the Build.
IncludeParamè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.
PreserveExistingMetadataParamètre Boolean facultatif.

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

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 TaskExtension Base Class.

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="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 de l'élément sont affichées entre parenthèses après l'élément.

Collection d'élémentsSommaire
MySourceItemsWithMetadatafile1.resx (MyMetadata="Hello")

 file2.resx (MyMetadata="Hello")

Task Reference
Tasks

Afficher: