CreateItem (attività)

Inserisce elementi di input nelle raccolte di elementi. Questo 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 altre informazioni, vedere Elementi.

Attributi

Nella tabella che segue vengono descritti i parametri dell'attività CreateItem.

Parametro	Descrizione
AdditionalMetadata	Parametro di matrice String facoltativo. Specifica metadati aggiuntivi da associare agli elementi di output. Specificare il nome e il valore dei metadati dell'elemento usando la sintassi seguente: 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 altre informazioni, vedere Procedura: Usare 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 specifiche di caratteri jolly. Per altre informazioni, vedere Elementi 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 specifiche di caratteri jolly.
PreserveExistingMetadata	Parametro Boolean facoltativo. Se True, i metadati aggiuntivi vengono applicati solo se non sono ancora presenti.

Osservazioni:

Oltre ai parametri elencati sopra, questa attività eredita i parametri dalla classe TaskExtension, che a sua volta eredita dalla classe Task. Per un elenco di questi parametri aggiuntivi e le rispettive descrizioni, vedere TaskExtension Base Class.

Esempio

L'esempio di codice seguente mostra come creare una nuova raccolta di elementi denominata MySourceItemsWithMetadata a partire dalla raccolta di elementi MySourceItems. L'attività CreateItem popola la nuova raccolta con elementi dell'elemento MySourceItems. A ogni elemento della nuova raccolta viene poi aggiunto un altro 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, entrambi con voci di metadati per MyMetadata. La raccolta di elementi MySourceItems rimane invariata.

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

La tabella seguente descrive 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")

Vedi anche

• Attività MSBuild
• Attività