Metadati di elementi noti di MSBuild
I metadati degli elementi sono valori associati agli elementi. Alcuni vengono assegnati da MSBuild agli elementi quando vengono creati gli elementi, ma è anche possibile definire tutti i metadati necessari. Alcuni valori di metadati definiti dall'utente hanno un significato per MSBuild, attività specifiche o SDK, ad esempio .NET SDK.
La tabella in questo articolo descrive i metadati assegnati a ogni elemento al momento della creazione. La tabella successiva mostra alcuni metadati facoltativi che hanno un significato per MSBuild, che è possibile definire per controllare il comportamento di compilazione. In ogni esempio, la dichiarazione di elemento seguente è stata usata per includere il file C:\MyProject\Source\Program.cs nel progetto.
<ItemGroup>
<MyItem Include="Source\Program.cs" />
</ItemGroup>
| Metadati dell'elemento | Descrizione |
|---|---|
| %(FullPath) | Contiene il percorso completo dell'elemento. Per esempio: C:\MyProject\Source\Program.cs |
| %(RootDir) | Contiene la directory radice dell'elemento. Per esempio: C:\ |
| %(nome file) | Contiene il nome file dell'elemento, senza l'estensione. Per esempio: programma di |
| %(estensione) | Contiene l'estensione del nome file dell'elemento. Per esempio: .cs |
| %(RelativeDir) | Contiene il percorso specificato nell'attributo Include, fino alla barra rovesciata finale (\). Per esempio:origine \ Se l'attributo Include è un percorso completo, %(RelativeDir) inizia con la directory radice %(RootDir). Per esempio: C:\MyProject\Source\ |
| %(directory) | Contiene la directory dell'elemento, senza la directory radice. Per esempio: MyProject\Source\ |
| %(RecursiveDir) | Se l'attributo Include contiene il carattere jolly **, questi metadati specificano la parte del percorso che sostituisce il carattere jolly. Per altre informazioni sui caratteri jolly, vedere Procedura: Selezionare i file da compilare.Se la cartella C:\MySolution\MyProject\Source\ contiene il file Program.cse se il file di progetto contiene questo elemento: <ItemGroup><MyItem Include="C:\**\Program.cs" /></ItemGroup>il valore di %(MyItem.RecursiveDir) sarà quindi MySolution\MyProject\Source\. |
| %(identità) | Elemento specificato nell'attributo Include. Per esempio:origine \Program.cs |
| %(ModifiedTime) | Contiene il timestamp dell'ultima modifica dell'elemento. Per esempio:2004-07-01 00:21:31.5073316 |
| %(CreatedTime) | Contiene il timestamp da quando è stato creato l'elemento. Per esempio:2004-06-25 09:26:45.8237425 |
| %(AccessedTime) | Contiene il timestamp dall'ultima volta che è stato eseguito l'accesso all'elemento.2004-08-14 16:52:36.3168743 |
| %(DefiningProjectFullPath) | Contiene il percorso completo del file di progetto (o del file importato) che definisce questo elemento. |
| %(DefiningProjectDirectory) | Contiene la directory del progetto del file di progetto (o file importato) che definisce questo elemento. |
| %(DefiningProjectName) | Contiene il nome del file di progetto (o file importato) che definisce questo elemento (senza l'estensione). |
| %(DefiningProjectExtension) | Contiene l'estensione del file di progetto (o del file importato) che definisce questo elemento. |