Elemento Item (MSBuild)
Aggiornamento: novembre 2007
Contiene un elemento definito dall'utente e i relativi metadati. Ogni elemento utilizzato in un progetto MSBuild deve essere specificato come elemento figlio di un elemento ItemGroup.
<Item Include="*.cs"
Exclude="MyFile.cs"
Condition="'String A'=='String B'" >
<ItemMetadata1>...</ItemMetadata1>
<ItemMetadata2>...</ItemMetadata2>
</Item>
Attributi ed elementi
Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio e padre.
Attributi
Attributo |
Descrizione |
---|---|
Include |
Attributo obbligatorio. File o carattere jolly da includere nell'elemento. |
Exclude |
Attributo facoltativo. File o carattere jolly da escludere dall'elemento. |
Condition |
Attributo facoltativo. Condizione da valutare. Per ulteriori informazioni, vedere Condizioni di MSBuild. |
Elementi figlio
Elemento |
Descrizione |
---|---|
Chiave di metadati dell'elemento definito dall'utente, che contiene il valore dei metadati dell'elemento. In un elemento, possono essere presenti zero o più elementi ItemMetadata. |
Elementi padre
Elemento |
Descrizione |
---|---|
Elemento di raggruppamento per gli elementi. |
Note
Gli elementi Item definiscono valori da immettere nel sistema di generazione e vengono raggruppati in insiemi in base ai relativi nomi di insieme definiti dall'utente. Questi insiemi di elementi possono essere utilizzati come parametri per le attività, che utilizzano i singoli elementi contenuti nell'insieme per eseguire le fasi del processo di generazione. Per ulteriori informazioni, vedere Elementi MSBuild.
La notazione @(myType) consente di espandere un insieme di elementi di tipo myType in un elenco di stringhe delimitato da punti e virgola e di passarlo a un parametro. Se il parametro è di tipo string, il relativo valore corrisponde all'elenco di elementi separati da punti e virgola. Se il parametro è una matrice di stringhe (string[]), ciascun elemento viene inserito nella matrice in base alla posizione dei punti e virgola. Se il parametro dell'attività è di tipo ITaskItem[], il valore corrisponde al contenuto dell'insieme di elementi con gli eventuali metadati associati. Per delimitare ciascun elemento con un carattere diverso da un punto e virgola, utilizzare la sintassi @(myType, 'separatore').
Il motore MSBuild consente di valutare sia caratteri jolly, ad esempio * e ?, che caratteri jolly ricorsivi, ad esempio /**/*.cs. Per ulteriori informazioni, vedere Elementi MSBuild.
Esempio
Nell'esempio di codice riportato di seguito viene illustrato come dichiarare due elementi di tipo CSFile. Il secondo elemento dichiarato contiene metadati con myAttribute impostato su HelloWorld.
<ItemGroup>
<CSFile Include="engine.cs; form.cs" />
<CSFile Include="main.cs" >
<MyMetadata>HelloWorld</MyMetadata>
</Item>
</ItemGroup>