Element typu položka (MSBuild)

Článek
03/04/2013

Obsahuje položka definovaná uživatelem a jeho metadata.Každé položky, který je používán MSBuild projektu musí být zadán jako podřízený ItemGroup prvku.

<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 rodičovské prvky.

Atributy

Atribut	Description
Include	Požadovaný atribut. Soubor nebo zástupné zahrnout do seznamu položek.
Exclude	Nepovinný atribut. Soubor nebo zástupné vyloučit ze seznamu položek.
Condition	Nepovinný atribut. Podmínka, která má být vyhodnocen.Další informace naleznete v tématu Nástroj MSBuild podmínky.
Remove	Nepovinný atribut. Soubor nebo zástupné odebrat ze seznamu položek. Tento atribut je platný pouze pokud je zadán pro položku ItemGroup v Target.
KeepMetadata	Nepovinný atribut. Metadata pro zdrojové položky přidat položky cíl.Pouze metadata, jejichž názvy jsou uvedeny v seznamu oddělený středníkem jsou přenesena z položky zdroje cílové položky.Další informace naleznete v tématu Nástroj MSBuild položky. Tento atribut je platný pouze pokud je zadán pro položku ItemGroup v Target.
RemoveMetadata	Nepovinný atribut. Metadata zdrojové položky nelze přenést do cílové položkyVšechna metadata je přenesena z položky zdroje cílové položky kromě metadat jejichž názvy jsou obsaženy v seznamu názvů oddělených středníkem.Další informace naleznete v tématu Nástroj MSBuild položky. Tento atribut je platný pouze pokud je zadán pro položku ItemGroup v Target.
KeepDuplicates	Nepovinný atribut. Určuje, zda má položka přidána do cílové skupiny, pokud je přesný duplikát již existující položky.Pokud zdrojová a cílová položka mít stejný Include hodnotu, ale různých metadat, je položka přidána i v případě KeepDuplicates je nastavena na false.Další informace naleznete v tématu Nástroj MSBuild položky. Tento atribut je platný pouze pokud je zadán pro položku ItemGroup v Target.

Podřízené elementy

Element	Description
ItemMetadata	Klíč metadata položky definované uživatelem, který obsahuje metadata hodnoty položky.Může být nula nebo více ItemMetadata prvky v položce.

Nadřazené elementy

Element	Description
ItemGroup	Prvek seskupení položek.

Poznámky

Itemprvky definovat vstupy do sestavení systému a jsou seskupeny do kolekcí zboží na základě jejich názvů uživatelsky definovaná kolekce.Tyto položky kolekce lze použít jako parametry pro úlohy, které pomocí jednotlivých položek v kolekcích kroků procesu sestavení.Další informace naleznete v tématu Nástroj MSBuild položky.

Pomocí zápisu @(myType) umožňuje kolekce položek typu myType na seznam řetězců oddělených středníkem a předán parametr.Pokud je parametr typu string, pak je hodnota parametru seznam prvků, které jsou odděleny 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 úlohy typu ITaskItem[], pak je hodnota obsahu kolekce položku s připojena metadata.Vymezení jednotlivých položek pomocí znaků než středníkem, použijte syntaxi @(myType, 'oddělovač').

MSBuild Motoru může vyhodnotit jako zástupné znaky * a ? a rekurzivní zástupné znaky, jako /**/*.cs.Další informace naleznete v tématu Nástroj MSBuild položky.

Příklad

Následující příklad kódu ukazuje, jak deklarovat dvě položky typu CSFile.Druhý deklarované zboží obsahuje metadata, která má myAttribute nastavena na HelloWorld.

<ItemGroup>
    <CSFile Include="engine.cs; form.cs" />
    <CSFile Include="main.cs" >
        <MyMetadata>HelloWorld</MyMetadata>
    </CSFile>
</ItemGroup>

Viz také

Koncepty

Nástroj MSBuild položky

Nástroj MSBuild vlastnosti

Odkaz na projekt MSBuild soubor schématu

Sdílet prostřednictvím