Bagikan melalui

Metadata item terkenal MSBuild

  • Artikel

Metadata item adalah nilai yang dilampirkan ke item. Beberapa ditetapkan oleh MSBuild ke item saat item dibuat, tetapi Anda juga dapat menentukan metadata apa pun yang Anda butuhkan. Beberapa nilai metadata yang ditentukan pengguna memiliki arti untuk MSBuild, tugas tertentu, atau SDK seperti .NET SDK.

Tabel pertama dalam artikel ini menjelaskan metadata yang ditetapkan untuk setiap item saat pembuatan. Tabel berikutnya memperlihatkan beberapa pilihan metadata yang memiliki arti untuk MSBuild, yang dapat Anda tentukan untuk mengontrol perilaku build. Dalam setiap contoh, deklarasi item berikut digunakan untuk menyertakan file C:\MyProject\Source\Program.cs dalam proyek.

<ItemGroup>
    <MyItem Include="Source\Program.cs" />
</ItemGroup>
Metadata item Deskripsi
%(FullPath) Berisi jalur lengkap item. Contohnya:

C:\MyProject\Source\Program.cs
%(RootDir) Berisi direktori akar item. Contohnya:

C:\
%(Filename) Berisi nama file item, tanpa ekstensi. Contohnya:

Program
%(Ekstensi) Berisi ekstensi nama file. Contohnya:

.cs
%(RelativeDir) Berisi path yang ditentukan dalam atribut Include, hingga garis miring terbalik (\). Contohnya:

Source\

Jika atribut Include adalah jalur lengkap, %(RelativeDir) dimulai dengan direktori akar %(RootDir). Misalnya:

C:\MyProject\Source\
%(Directory) Berisi direktori item, tanpa direktori akar. Contohnya:

MyProject\Source\
%(RecursiveDir) Jika atribut Include berisi wildcard **, metadata ini menentukan bagian dari jalur yang menggantikan wildcard tersebut. Untuk informasi selengkapnya pada wildcard, lihat Cara: Memilih file yang akan dibuat.

Jika folder C:\MySolution\MyProject\Source\ berisi file Program.cs, dan jika file proyek berisi item ini:

<ItemGroup>

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

</ItemGroup>

nilainya %(MyItem.RecursiveDir) adalah MySolution\MyProject\Source\.
%(Identity) Item yang ditentukan dalam atribut Include. Contohnya:

Source\Program.cs
%(ModifiedTime) Berisi tanda waktu dari terakhir kali item dimodifikasi. Contohnya:

2004-07-01 00:21:31.5073316
%(CreatedTime) Berisi tanda waktu dari ketika item dibuat. Contohnya:

2004-06-25 09:26:45.8237425
%(AccessedTime) Berisi tanda waktu dari terakhir kali item dimodifikasi.

2004-08-14 16:52:36.3168743
%(DefiningProjectFullPath) Berisi jalur lengkap file proyek (atau file yang diimpor) yang menentukan item ini.
%(DefiningProjectDirectory) Berisi direktori proyek file proyek (atau file yang diimpor) yang menentukan item ini.
%(DefiningProjectName) Berisi nama file proyek (atau file yang diimpor) yang menentukan item ini (tanpa ekstensi).
%(DefiningProjectExtension) Berisi ekstensi file proyek (atau file yang diimpor) yang menentukan item ini.

Baca juga