Item – prvek (MSBuild)
Obsahuje uživatelsky definovanou položku a jeho metadata.Každá položka, která se používá v MSBuild projektu musí být zadán jako podřízený ItemGroup elementu.
<Item Include="*.cs" Exclude="MyFile.cs" Remove="RemoveFile.cs" Condition="'String A'=='String B'" > <ItemMetadata1>...</ItemMetadata1> <ItemMetadata2>...</ItemMetadata2> </Item>
Atributy a elementy
Následující části popisují atributy, podřízené prvky a nadřazené prvky.
Atributy
Atribut |
Popis |
|---|---|
Include |
Požadovaný atribut. Soubor nebo zástupnými znaky, které mají být zahrnuty do seznamu položek. |
Exclude |
Nepovinný atribut. Soubor nebo zástupnými znaky, které mají být vyloučena ze seznamu položek. |
Condition |
Nepovinný atribut. Podmínka, který se má vyhodnotit.Další informace naleznete v tématu Podmínky nástroje MSBuild. |
Remove |
Nepovinný atribut. Soubor nebo zástupnými znaky odebrání ze seznamu položek. Tento atribut je platný pouze tehdy, pokud je zadán pro položku v ItemGroup které se nachází v Target. |
KeepMetadata |
Nepovinný atribut. Metadata pro položky zdroje, které chcete přidat do cílové položky.Pouze metadata, jejichž názvy jsou uvedeny v seznamu oddělené středníky přenášených z položky zdroje na položku cíl.Další informace naleznete v tématu Položky nástroje MSBuild. Tento atribut je platný pouze tehdy, pokud je zadán pro položku v ItemGroup které se nachází v Target. |
RemoveMetadata |
Nepovinný atribut. Metadata pro zdroj položky, které chcete-li k přenosu k položkám cíl.Všechna metadata přenášen z zdroj položky k položce cíl s výjimkou metadat jejichž názvy jsou obsaženy v seznamu názvů oddělených středníkem.Další informace naleznete v tématu Položky nástroje MSBuild. Tento atribut je platný pouze tehdy, pokud je zadán pro položku v ItemGroup které se nachází v Target. |
KeepDuplicates |
Nepovinný atribut. Určuje, zda položku by měl bude přidán do cílové skupiny, pokud je přesné kopii existující položku.Pokud je zdrojová a cílová položka mít stejný Include hodnota, ale jiné metadat, položka je přidaný i v případě KeepDuplicates je nastavena na false.Další informace naleznete v tématu Položky nástroje MSBuild. Tento atribut je platný pouze tehdy, pokud je zadán pro položku v ItemGroup které se nachází v Target. |
Podřízené elementy
Prvek |
Popis |
|---|---|
Klíč metadata položky definované uživatelem, který obsahuje hodnotu položky metadat.Může být nula nebo více ItemMetadata prvky v položce. |
Nadřazené elementy
Prvek |
Popis |
|---|---|
Seskupení elementu pro položky. |
Poznámky
Itemelementy definovat vstupů do systému sestavení a jsou seskupeny do kolekcí položek na základě jejich uživatelsky definovaná kolekce názvů.Tyto položky kolekce lze použít jako parametry pro úlohy, který umožňuje jednotlivé položky v kolekcích postupujte podle pokynů procesu sestavení.Další informace naleznete v tématu Položky nástroje MSBuild.
Pomocí zápisu @(myType) umožňuje kolekce položek typu myType rozšířit do oddělených středníkem seznam řetězců a předaný parametr.Pokud je parametr typu string, pak je hodnota parametru seznamu prvků, oddělené středníky.Pokud je parametr pole řetězců (string[]), pak každý prvek je vložen do pole na základě umístění středníky.Pokud je parametr úloha typu ITaskItem[], hodnota bude obsah kolekce položek spolu s žádná metadata připojit.Pro každou položku vymezení pomocí jiný znak než středník, použijte syntaxi @(myType, 'oddělovač').
MSBuild Modul mohou vyhodnotit zástupné znaky, jako * a ? a rekurzivní zástupné znaky, jako /**/*.cs.Další informace naleznete v tématu Položky nástroje MSBuild.
Příklad
Následující příklad kódu ukazuje, jak deklarovat dvě položky typu CSFile.Druhý deklarován položka obsahuje metadata, která má MyMetadata nastavena na HelloWorld.
<ItemGroup>
<CSFile Include="engine.cs; form.cs" />
<CSFile Include="main.cs" >
<MyMetadata>HelloWorld</MyMetadata>
</CSFile>
</ItemGroup>
Viz také
Koncepty
Referenční dokumentace schématu souboru projektu nástroje MSBuild