MSBuild bekende itemmetagegevens
Metagegevens van items zijn waarden die zijn gekoppeld aan items. Sommige worden door MSBuild toegewezen aan items wanneer items worden gemaakt, maar u kunt ook metagegevens definiëren die u nodig hebt. Sommige door de gebruiker gedefinieerde metagegevenswaarden hebben betekenis voor MSBuild, specifieke taken of SDK's, zoals de .NET SDK.
In de tabel in dit artikel worden de metagegevens beschreven die bij het maken aan elk item zijn toegewezen. De volgende tabel bevat enkele optionele metagegevens die betekenis hebben voor MSBuild, die u kunt definiëren om het buildgedrag te beheren. In elk voorbeeld is de volgende itemdeclaratie gebruikt om het bestand C:\MyProject\Source\Program.cs in het project op te nemen.
<ItemGroup>
<MyItem Include="Source\Program.cs" />
</ItemGroup>
| Metagegevens van items | Beschrijving |
|---|---|
| %(FullPath) | Bevat het volledige pad van het item. Bijvoorbeeld: C:\MyProject\Source\Program.cs |
| %(RootDir) | Bevat de hoofdmap van het item. Bijvoorbeeld: C:\ |
| %(bestandsnaam) | Bevat de bestandsnaam van het item, zonder de extensie. Bijvoorbeeld: Program- |
| %(extensie) | Bevat de bestandsnaamextensie van het item. Bijvoorbeeld: .cs |
| %(RelativeDir) | Bevat het pad dat is opgegeven in het kenmerk Include, tot aan de laatste backslash (\). Bijvoorbeeld:Bron\- Als het kenmerk Include een volledig pad is, begint %(RelativeDir) met de hoofdmap %(RootDir). Bijvoorbeeld: C:\MyProject\Source\ |
| %(directory) | Bevat de map van het item, zonder de hoofdmap. Bijvoorbeeld: MyProject\Source\ |
| %(RecursiveDir) | Als het kenmerk Include het jokerteken ** bevat, geeft deze metagegevens het deel aan van het pad dat het jokerteken vervangt. Zie Procedures voor meer informatie over jokertekens: Selecteer de bestanden omte bouwen.Als de map C:\MySolution\MyProject\Source\ het bestand bevat Program.csen als het projectbestand dit item bevat: <ItemGroup><MyItem Include="C:\**\Program.cs" /></ItemGroup>dan wordt de waarde van %(MyItem.RecursiveDir)MySolution\MyProject\Source\. |
| %(identiteit) | Het item dat is opgegeven in het kenmerk Include. Bijvoorbeeld:bron\Program.cs |
| %(ModifiedTime) | Bevat de tijdstempel van de laatste keer dat het item is gewijzigd. Bijvoorbeeld:2004-07-01 00:21:31.5073316 |
| %(CreatedTime) | Bevat de tijdstempel van het moment waarop het item is gemaakt. Bijvoorbeeld:2004-06-25 09:26:45.8237425 |
| %(AccessedTime) | Bevat de tijdstempel van de laatste keer dat het item werd geopend.2004-08-14 16:52:36.3168743 |
| %(DefiningProjectFullPath) | Bevat het volledige pad van het projectbestand (of geïmporteerd bestand) dat dit item definieert. |
| %(DefiningProjectDirectory) | Bevat de projectmap van het projectbestand (of geïmporteerd bestand) dat dit item definieert. |
| %(DefiningProjectName) | Bevat de naam van het projectbestand (of geïmporteerd bestand) dat dit item definieert (zonder de extensie). |
| %(DefiningProjectExtension) | Bevat de extensie van het projectbestand (of geïmporteerd bestand) dat dit item definieert. |