Attività CreateItem
Inserisce gli elementi di input nelle raccolte di elementi.Ciò consente di copiare gli elementi da un elenco all'altro.
[!NOTA]
Si tratta di un'attività deprecata.A partire da .NET Framework 3.5, è possibile posizionare i gruppi di elementi all'interno di elementi Target.Per ulteriori informazioni, vedere Elementi MSBuild.
Attributi
Nella tabella riportata di seguito sono descritti i parametri dell'attività CreateItem.
Parametro |
Descrizione |
|---|---|
AdditionalMetadata |
Parametro matrice String facoltativo. Specifica ulteriori metadati da associare agli elementi di output.Specificare il nome e il valore di metadati per l'elemento utilizzando la seguente sintassi: NomeMetadati=ValoreMetadati Le coppie nome/valore di metadati devono essere separate da un punto e virgola.Se il nome o il valore contiene un punto e virgola o qualsiasi altro carattere speciale, questo deve essere preceduto dal carattere di escape.Per ulteriori informazioni, vedere Procedura: utilizzare caratteri di escape speciali in MSBuild. |
Exclude |
Parametro di output ITaskItem[] facoltativo. Specifica gli elementi da escludere dalla raccolta di elementi di output.Questo parametro può contenere le specifiche dei caratteri jolly.Per ulteriori informazioni, vedere Elementi MSBuild e Procedura: escludere file dalla compilazione. |
Include |
Parametro ITaskItem[] obbligatorio. Specifica gli elementi da includere nella raccolta di elementi di output.Questo parametro può contenere le specifiche dei caratteri jolly. |
PreserveExistingMetadata |
Parametro Boolean facoltativo. Se True, i metadati aggiuntivi vengono applicati soltanto se non sono già presenti. |
Note
Oltre ai parametri sopra elencati, questa attività eredita i parametri dalla classe TaskExtension, che eredita dalla classe Task.Per un elenco di tali parametri aggiuntivi e le relative descrizioni, vedere Classe di base TaskExtension.
Esempio
Nell'esempio di codice riportato di seguito viene creata una nuova raccolta di elementi denominata MySourceItemsWithMetadata a partire dalla raccolta di elementi MySourceItems.L'attività CreateItem popola la nuova raccolta di elementi con elementi nell'elemento MySourceItems.A ogni elemento della nuova raccolta viene poi aggiunto un ulteriore metadato denominato MyMetadata di valore Hello.
Al termine dell'esecuzione dell'attività, la raccolta di elementi MySourceItemsWithMetadata contiene gli elementi file1.resx e file2.resx, che dispongono entrambi di voci di metadati per MyMetadata.La raccolta di elementi MySourceItems rimane invariata.
<Project xmlns="https://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>
Nella tabella riportata di seguito viene descritto il valore dell'elemento di output dopo l'esecuzione dell'attività.I metadati degli elementi vengono visualizzati tra parentesi dopo l'elemento.
Raccolta di elementi |
Contenuto |
|---|---|
MySourceItemsWithMetadata |
file1.resx (MyMetadata="Hello") file2.resx (MyMetadata="Hello") |