Métadonnées d’élément connues MSBuild
Les métadonnées d’élément sont des valeurs attachées aux éléments. Certains sont affectés par MSBuild aux éléments lorsque des éléments sont créés, mais vous pouvez également définir les métadonnées dont vous avez besoin. Certaines valeurs de métadonnées définies par l’utilisateur ont une signification pour MSBuild, des tâches spécifiques ou des kits SDK tels que le Kit de développement logiciel (SDK) .NET.
Le tableau de cet article décrit les métadonnées affectées à chaque élément lors de la création. Le tableau suivant présente certaines métadonnées facultatives qui ont une signification pour MSBuild, que vous pouvez définir pour contrôler le comportement de génération. Dans chaque exemple, la déclaration d’élément suivante a été utilisée pour inclure le fichier C :\MyProject\Source\Program.cs dans le projet.
<ItemGroup>
<MyItem Include="Source\Program.cs" />
</ItemGroup>
| Métadonnées d’élément | Description |
|---|---|
| %(FullPath) | Contient le chemin d’accès complet de l’élément. Par exemple: C :\MyProject\Source\Program.cs |
| %(RootDir) | Contient le répertoire racine de l’élément. Par exemple: C :\ |
| %(nom de fichier) | Contient le nom de fichier de l’élément, sans l’extension. Par exemple: programme |
| %(extension) | Contient l’extension de nom de fichier de l’élément. Par exemple: .cs |
| %(RelativeDir) | Contient le chemin d’accès spécifié dans l’attribut Include, jusqu’à la barre oblique inverse finale (\). Par exemple:Source\ Si l’attribut Include est un chemin d’accès complet, %(RelativeDir) commence par le répertoire racine %(RootDir). Par exemple: C :\MyProject\Source\ |
| %(répertoire) | Contient le répertoire de l’élément, sans le répertoire racine. Par exemple: MyProject\Source\ |
| %(RecursiveDir) | Si l’attribut Include contient le caractère générique **, ces métadonnées spécifient la partie du chemin d’accès qui remplace le caractère générique. Pour plus d’informations sur les caractères génériques, consultez Guide pratique pour sélectionner les fichiers à générer.Si le dossier C :\MySolution\MyProject\Source\ contient le fichier Program.cset si le fichier projet contient cet élément : <ItemGroup><MyItem Include="C:\**\Program.cs" /></ItemGroup>alors la valeur de %(MyItem.RecursiveDir) serait MySolution\MyProject\Source\. |
| %(Identité) | Élément spécifié dans l’attribut Include. Par exemple:source \Program.cs |
| %(ModifiedTime) | Contient l’horodatage à partir de la dernière modification de l’élément. Par exemple:2004-07-01 00:21:31.5073316 |
| %(CreatedTime) | Contient l’horodatage à partir duquel l’élément a été créé. Par exemple:2004-06-25 09:26:45.8237425 |
| %(AccessedTime) | Contient l’horodatage à partir de la dernière fois que l’élément a été accédé.2004-08-14 16:52:36.3168743 |
| %(DefiningProjectFullPath) | Contient le chemin complet du fichier projet (ou fichier importé) qui définit cet élément. |
| %(DefiningProjectDirectory) | Contient le répertoire du projet du fichier projet (ou fichier importé) qui définit cet élément. |
| %(DefiningProjectName) | Contient le nom du fichier projet (ou fichier importé) qui définit cet élément (sans l’extension). |
| %(DefiningProjectExtension) | Contient l’extension du fichier projet (ou fichier importé) qui définit cet élément. |