MSBuild tanınmış öğe meta verileri
Öğe meta verileri öğelere eklenen değerlerdir. Öğeler oluşturulduğunda bazıları MSBuild tarafından öğelere atanır, ancak ihtiyacınız olan meta verileri de tanımlayabilirsiniz. Bazı kullanıcı tanımlı meta veri değerlerinin MSBuild, belirli görevler veya .NET SDK gibi SDK'lar için anlamı vardır.
Bu makaledeki ilk tabloda, oluşturma işleminden sonra her öğeye atanan meta veriler açıklanmaktadır. Sonraki tabloda, derleme davranışını denetlemek için tanımlayabileceğiniz MSBuild için anlamı olan bazı isteğe bağlı meta veriler gösterilir. Her örnekte, projeye C:\MyProject\Source\Program.cs dosyasını eklemek için aşağıdaki öğe bildirimi kullanılmıştır.
<ItemGroup>
<MyItem Include="Source\Program.cs" />
</ItemGroup>
| Öğe meta verileri | Açıklama |
|---|---|
| %(FullPath) | Öğenin tam yolunu içerir. Örneğin: C:\MyProject\Source\Program.cs |
| %(RootDir) | Öğenin kök dizinini içerir. Örneğin: C:\ |
| %(Dosya Adı) | Uzantı olmadan öğenin dosya adını içerir. Örneğin: Program |
| %(Uzantı) | Öğenin dosya adı uzantısını içerir. Örneğin: .Cs |
| %(RelativeDir) | Özniteliğinde Include son ters eğik çizgiye (\) kadar belirtilen yolu içerir. Örneğin:Kaynak\ Include Özniteliği tam bir yolsa, %(RelativeDir) kök diziniyle %(RootDir)başlar. Örneğin: C:\MyProject\Source\ |
| %(Dizin) | Kök dizini olmadan öğenin dizinini içerir. Örneğin: MyProject\Source\ |
| %(RecursiveDir) | Include Özniteliği joker karakteri ** içeriyorsa, bu meta veriler yolun joker karakterin yerini alan bölümünü belirtir. Joker karakterler hakkında daha fazla bilgi için bkz . Nasıl yapılır: Derlemek için dosyaları seçme.C:\MySolution\MyProject\Source\ klasörü Program.cs dosyasını içeriyorsa ve proje dosyası şu öğeyi içeriyorsa: <ItemGroup><MyItem Include="C:\**\Program.cs" /></ItemGroup>%(MyItem.RecursiveDir) değeri MySolution\MyProject\Source\ olur. |
| %(Kimlik) | Özniteliğinde Include belirtilen öğe. Örneğin:Source\Program.cs |
| %(ModifiedTime) | Öğenin son değiştirildiği zamana ait zaman damgasını içerir. Örneğin:2004-07-01 00:21:31.5073316 |
| %(CreatedTime) | Öğenin oluşturulduğu zaman damgasını içerir. Örneğin:2004-06-25 09:26:45.8237425 |
| %(AccessedTime) | Öğeye en son erişildiğinden kalan zaman damgasını içerir.2004-08-14 16:52:36.3168743 |
| %(DefiningProjectFullPath) | Bu öğeyi tanımlayan proje dosyasının (veya içeri aktarılan dosyanın) tam yolunu içerir. |
| %(DefiningProjectDirectory) | Bu öğeyi tanımlayan proje dosyasının (veya içeri aktarılan dosyanın) proje dizinini içerir. |
| %(DefiningProjectName) | Bu öğeyi tanımlayan proje dosyasının (veya içeri aktarılan dosyanın) adını içerir (uzantı olmadan). |
| %(DefiningProjectExtension) | Bu öğeyi tanımlayan proje dosyasının (veya içeri aktarılan dosyanın) uzantısını içerir. |