Attività CreateItem
Aggiornamento: novembre 2007
Inserisce gli elementi di input negli insiemi di elementi. Ciò consente di copiare gli elementi da un elenco all'altro.
Attributi
Nella tabella riportata di seguito sono descritti i parametri dell'attività CreateItem.
Parametro |
Descrizione |
|---|---|
AdditionalMetadata |
Parametro 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 ITaskItem[] facoltativo. Specifica gli elementi da escludere dall'insieme di elementi di output. Questo parametro può contenere le specifiche dei caratteri jolly. Per ulteriori informazioni, vedere Elementi MSBuild e Procedura: compilare tutti i file di una directory tranne uno. |
Include |
Parametro di output ITaskItem[] facoltativo. Specifica gli elementi da includere nell'insieme di elementi di output. Questo parametro può contenere le specifiche dei caratteri jolly. |
Esempio
Nell'esempio di codice riportato di seguito viene creato un nuovo insieme di elementi denominato MySourceItemsWithMetadata a partire dall'insieme di elementi MySourceItems. L'attività CreateItem inserisce nel nuovo insieme di elementi gli elementi di MySourceItems i cui valori di MyAddMetadata sono impostati su true. A ogni elemento del nuovo insieme viene poi aggiunto un ulteriore metadato denominato MyMetadata di valore Hello.
Al termine dell'esecuzione dell'attività, l'insieme di elementi MySourceItemsWithMetadata contiene gli elementi file1.resx e file3.resx, che dispongono di metadati per MyAddMetadata e MyMetadata. L'insieme di elementi MySourceItems rimane invariato.
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<MySourceItems Include="file1.resx;file3.resx">
<MyAddMetadata>true</MyAddMetadata>
</MySourceItems>
<MySourceItems Include="file2.resx">
<MyAddMetadata>false</MyAddMetadata>
</MySourceItems>
</ItemGroup>
<PropertyGroup>
<MyValue>Hello</MyValue>
</PropertyGroup>
<Target Name="NewItems">
<CreateItem
Include="@(MySourceItems)"
Condition="'%(MyAddMetadata)'=='true'"
AdditionalMetadata="MyMetadata=$(MyValue)">
<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.
Insieme di elementi |
Contenuto |
|---|---|
MySourceItemsWithMetadata |
file1.resx (MyMetadata="Hello") file3.resx (MyMetadata="Hello") |