Sdílet prostřednictvím

Metadata známé položky nástroje MSBuild

  • Článek

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.

První 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. Příklad:

C:\MyProject\Source\Program.cs
%(RootDir) Obsahuje kořenový adresář položky. Příklad:

C:\
%(Název souboru) Obsahuje název souboru položky bez přípony. Příklad:

Program
%(Rozšíření) Obsahuje příponu názvu souboru položky. Příklad:

.Cs
%(RelativeDir) Obsahuje cestu zadanou v atributu Include až do konečného zpětného lomítka (\). Příklad:

Zdroj\

Include Pokud je atribut ú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. Příklad:

MyProject\Source\
%(Rekurzivnídir) Include Pokud atribut obsahuje zástupný znak **, tato metadata určuje část cesty, která nahradí zástupný znak. Další informace o zástupných

Pokud složka C:\MySolution\MyProject\Source\ obsahuje soubor Program.cs a pokud soubor projektu obsahuje tuto položku:

<ItemGroup>

<MyItem Include="C:\**\Program.cs" />

</ItemGroup>

hodnota %(MyItem.RecursiveDir) by pak byla MySolution\MyProject\Source\.
%(Identita) Položka zadaná v atributu Include . Příklad:

Source\Program.cs
%(ModifiedTime) Obsahuje časové razítko od poslední změny položky. Příklad:

2004-07-01 00:21:31.5073316
%(CreatedTime) Obsahuje časové razítko od vytvoření položky. Pří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
%(DefiningProjectFullPath) 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).
%(DefiningProjectExtension) Obsahuje příponu souboru projektu (nebo importovaného souboru), který definuje tuto položku.

Viz také