Metadata známých položek nástroje MSBuild

Metadata položek jsou hodnoty připojené k položkám. Některé objekty jsou při vytváření položek přiřazeny nástrojem MSBuild, ale můžete také definovat všechna potřebná metadata. Některé hodnoty metadat definovaných uživatelem mají význam pro MSBuild, konkrétní úlohy nebo sady SDK, jako je sada .NET SDK.

Tabulka v tomto článku popisuje metadata přiřazená ke každé položce při vytváření. V další tabulce jsou uvedena některá volitelná metadata, která mají význam pro NÁSTROJ MSBuild, která můžete definovat pro řízení chování sestavení. V každém příkladu byla použita následující deklarace položky k zahrnutí souboru C:\MyProject\Source\Program.cs v projektu.

<ItemGroup>
    <MyItem Include="Source\Program.cs" />
</ItemGroup>

Metadata položek	Popis
%(FullPath)	Obsahuje úplnou cestu k položce. Například: C:\MyProject\Source\Program.cs
%(kořenový adresář)	Obsahuje kořenový adresář položky. Například: C:\
%(název souboru)	Obsahuje název souboru položky bez přípony. Například: program
%(rozšíření)	Obsahuje příponu názvu souboru položky. Například: .cs
%(RelativeDir)	Obsahuje cestu zadanou v atributu Include až do konečného zpětného lomítka (\). Například: Source\ Pokud je atribut Include úplná cesta, %(RelativeDir) začíná kořenovým adresářem %(RootDir). Například: C:\MyProject\Source\
%(adresář)	Obsahuje adresář položky bez kořenového adresáře. Například: MyProject\Source\
%(Rekurzivnídir)	Pokud atribut Include obsahuje zástupný znak **, tato metadata určuje část cesty, která nahradí zástupný znak. Další informaceochch Pokud složka C:\MySolution\MyProject\Source\ obsahuje soubor Program.csa pokud soubor projektu obsahuje tuto položku: <ItemGroup> <MyItem Include="C:\**\Program.cs" /> </ItemGroup> pak by hodnota %(MyItem.RecursiveDir) byla MySolution\MyProject\Source\.
%(identita)	Položka zadaná v atributu Include. Například: zdroj \Program.cs
%(ModifiedTime)	Obsahuje časové razítko od poslední změny položky. Například: 2004-07-01 00:21:31.5073316
%(CreatedTime)	Obsahuje časové razítko od vytvoření položky. Například: 2004-06-25 09:26:45.8237425
%(AccessedTime)	Obsahuje časové razítko od posledního přístupu k položce. 2004-08-14 16:52:36.3168743
%(definiceProjectFullPath)	Obsahuje úplnou cestu k souboru projektu (nebo importovanému souboru), který definuje tuto položku.
%(DefiningProjectDirectory)	Obsahuje adresář projektu souboru projektu (nebo importovaného souboru), který definuje tuto položku.
%(DefiningProjectName)	Obsahuje název souboru projektu (nebo importovaného souboru), který definuje tuto položku (bez přípony).
%(definiceProjectExtension)	Obsahuje příponu souboru projektu (nebo importovaného souboru), který definuje tuto položku.

Viz také

• běžných metadat položek nástroje MSBuild
• položek
• dávkové
• referenční nástroje MSBuild