Elemento Item (MSBuild)
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 ItemGroup elemento.
<Progetto>
<ItemGroup>
<Articolo>
Sintassi
<Item Include="*.cs"
Exclude="MyFile.cs"
Condition="'String A'=='String B'">
<ItemMetadata1>...</ItemMetadata1>
<ItemMetadata2>...</ItemMetadata2>
</Item>
Specificare i metadati come attributi
In MSBuild 15.1 o versioni successive, un metadato con un nome che non è in conflitto con l'elenco di attributi corrente può essere espresso come un attributo.
Ad esempio, per specificare un elenco di pacchetti NuGet, si userebbe normalmente una sintassi simile alla seguente:
<ItemGroup>
<PackageReference Include="Newtonsoft.Json">
<Version>9.0.1-beta1<Version>
</PackageReference>
</ItemGroup>
Ora è tuttavia possibile passare il metadato Version come un attributo, come illustrato nella sintassi seguente:
<ItemGroup>
<PackageReference Include="Newtonsoft.Json" Version="9.0.1-beta1" />
</ItemGroup>
Attributi ed elementi
Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.
Attributi
| Attributo | Descrizione |
|---|---|
Include |
Attributo facoltativo. Il file o carattere jolly da includere nell'elenco di elementi. |
Exclude |
Attributo facoltativo. Il file o carattere jolly da escludere dall'elenco di elementi. |
Condition |
Attributo facoltativo. La condizione da valutare. Per altre informazioni, vedere Condizioni. |
Remove |
Attributo facoltativo. Il file o carattere jolly da eliminare dall'elenco di elementi. |
MatchOnMetadata |
Attributo facoltativo.Remove Modifica gli attributi che fanno riferimento ad altri elementi in modo che corrispondano ai nomi di metadati specificati invece di corrispondere ai valori degli elementi a cui si fa riferimento. Questo attributo è valido solo se viene specificato insieme a un Remove attributo che contiene solo riferimenti ad altri elementi , ad esempio Remove="@(Compile);@(Content)". Altri dettagli in Elementi. |
MatchOnMetadataOptions |
Attributo facoltativo. Specifica la strategia di corrispondenza delle stringhe utilizzata da MatchOnMetadata. I valori possibili sono CaseSensitive, CaseInsensitiveo PathLike. Il valore predefinito è CaseInsensitive. |
KeepDuplicates |
Attributo facoltativo. Specifica se un elemento deve essere aggiunto al gruppo di destinazione se è un duplicato esatto di un elemento esistente. Se l'elemento di origine e destinazione hanno lo stesso valore Include, ma metadati diversi, l'elemento viene aggiunto anche se KeepDuplicates è impostato su false. Per altre informazioni, vedere Elementi.Questo attributo è valido solo se è stato specificato per un elemento in un ItemGroup che si trova in un Target. |
KeepMetadata |
Attributo facoltativo. I metadati per gli elementi di origine da aggiungere agli elementi di destinazione. Solo i metadati i cui nomi vengono specificati nell'elenco delimitato da punto e virgola vengono trasferiti da un elemento di origine a un elemento di destinazione. Per altre informazioni, vedere Elementi. Questo attributo è valido solo se è stato specificato per un elemento in un ItemGroup che si trova in un Target. |
RemoveMetadata |
Attributo facoltativo. I metadati per gli elementi di origine da non trasferire agli elementi di destinazione. Tutti i metadati vengono trasferiti da un elemento di origine a un elemento di destinazione, ad eccezione dei metadati i cui nomi sono contenuti nell'elenco di nomi separati da punto e virgola. Per altre informazioni, vedere Elementi. Questo attributo è valido solo se è stato specificato per un elemento in un ItemGroup che si trova in un Target. |
Update |
Attributo facoltativo. È disponibile solo per i progetti .NET Core in Visual Studio 2017 o versioni successive. Consente di modificare i metadati di un elemento; in genere usato per eseguire l'override dei metadati predefiniti di elementi specifici dopo che inizialmente viene specificato un gruppo di elementi, ad esempio con un carattere jolly. Questo attributo è valido solo se è stato specificato per un elemento in un ItemGroup che non si trova in un Target. |
Elementi figlio
| Elemento | Descrizione |
|---|---|
| ItemMetadata | Chiave dei metadati di elemento definita dall'utente che contiene il valore dei metadati dell'elemento. Possono esistere zero o più elementi ItemMetadata in un elemento. |
Elementi padre
| Elemento | Descrizione |
|---|---|
| ItemGroup | Elemento di raggruppamento per elementi. |
Osservazioni:
Gli elementi Item definiscono gli input nel sistema di compilazione e vengono raggruppati in raccolte di elementi in base ai relativi nomi definiti dall'utente. Queste raccolte di elementi possono essere usate come parametri per le attività, che a loro volta usano i singoli elementi nelle raccolte per eseguire i passaggi del processo di compilazione. Per altre informazioni, vedere Elementi.
L'uso della notazione @(<myType>) consente l'espansione di una raccolta di elementi di tipo <myType> in un elenco di stringhe delimitato da punto e virgola e passato a un parametro. Se il parametro è di tipo string, il valore del parametro è l'elenco di elementi, separati da punti e virgola. Se il parametro è una matrice di stringhe (string[]), ogni elemento viene inserito nella matrice in base alla posizione dei punti e virgola. Se il parametro dell'attività è di tipo ITaskItem[], il valore è il contenuto della raccolta di elementi con eventuali metadati associati. Per delimitare ogni elemento usando un carattere diverso da un punto e virgola, usare la sintassi @(<myType>, '<separator>').
Il motore MSBuild può valutare caratteri jolly come * e e ? caratteri jolly ricorsivi, ad esempio /**/*.cs. Per altre informazioni, vedere Elementi.
Esempi
Nell'esempio di codice seguente viene illustrato come dichiarare due elementi di tipo CSFile. Il secondo elemento dichiarato contiene i metadati con MyMetadata impostato su HelloWorld.
<ItemGroup>
<CSFile Include="engine.cs; form.cs" />
<CSFile Include="main.cs" >
<MyMetadata>HelloWorld</MyMetadata>
</CSFile>
</ItemGroup>
L'esempio di codice seguente illustra come usare l'attributo Update per modificare i metadati in un file denominato somefile.cs, incluso tramite un criterio GLOB. È disponibile solo per i progetti .NET Core in Visual Studio 2017 o versioni successive.
<ItemGroup>
<Compile Update="somefile.cs"> // or Update="*.designer.cs"
<MetadataKey>MetadataValue</MetadataKey>
</Compile>
</ItemGroup>