Attività CreateItem

Inserisce gli elementi di input negli insiemi di elementi. Ciò consente di copiare gli elementi da un elenco all'altro.

Nota
Si tratta di un'attività obsoleta.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	Oggetto di 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 dall'insieme 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 nell'insieme 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 creato un nuovo insieme di elementi denominato MySourceItemsWithMetadata a partire dall'insieme di elementi MySourceItems. L'attività CreateItem popola il nuovo insieme di elementi con elementi nell'elemento MySourceItems. 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 file2.resx, che dispongono entrambi di voci di metadati per MyMetadata. L'insieme di elementi MySourceItems rimane invariato.

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

Insieme di elementi	Contenuto
MySourceItemsWithMetadata	file1.resx (MyMetadata="Hello") file2.resx (MyMetadata="Hello")

Vedere anche

Concetti

Attività di MSBuild

Altre risorse

Riferimenti delle attività MSBuild