Fichiers .targets MSBuild

  • Article

MSBuild inclut plusieurs fichiers .targets contenant des éléments, des propriétés, des cibles et des tâches pour les scénarios courants. Ces fichiers sont importés automatiquement dans la plupart des fichiers projet Visual Studio pour en simplifier la maintenance et la lisibilité.

Les projets importent généralement un ou plusieurs fichiers .targets pour définir leur processus de génération. Par exemple, un projet C# créé par Visual Studio importera Microsoft.CSharp.targets qui importe Microsoft.Common.targets. Le projet C# lui-même définit les éléments et les propriétés spécifiques à ce projet, mais les règles de build standard d’un projet C# sont définies dans les fichiers .targets importés.

La valeur $(MSBuildToolsPath) spécifie le chemin de ces fichiers .targets courants. Si ToolsVersion est égale à 4.0, les fichiers se trouvent à l’emplacement suivant : <WindowsInstallationPath>\Microsoft.NET\Framework\v4.0.30319\

Notes

Pour plus d’informations sur la création de vos propres cibles, consultez l’article Targets (Cibles MSBuild). Pour plus d’informations sur l’utilisation de l’élément Import pour insérer un fichier projet dans un autre fichier projet, consultez les articles Import, élément (MSBuild) et Guide pratique pour utiliser la même cible dans plusieurs fichiers projet.

Fichiers .targets communs

Fichier .targets Description
Microsoft.Common.targets Définit les étapes du processus de génération standard pour les projets Visual Basic et C#.

Importé par les fichiers Microsoft.CSharp.targets et Microsoft.VisualBasic.targets, qui incluent l’instruction suivante : <Import Project="Microsoft.Common.targets" />
Microsoft.CSharp.targets Définit les étapes du processus de génération standard pour les projets Visual C#.

Importé par les fichiers projet Visual C# (.csproj), qui incluent l’instruction suivante: <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
Microsoft.VisualBasic.targets Définit les étapes du processus de génération standard pour les projets Visual Basic.

Importé par les fichiers projet Visual Basic (.vbproj), qui incluent l’instruction suivante : <Import Project="$(MSBuildToolsPath)\Microsoft.VisualBasic.targets" />

Directory.Build.targets

Directory.Build.targets est un fichier défini par l’utilisateur qui fournit des personnalisations aux projets situés dans un répertoire. Ce fichier est automatiquement importé depuis Microsoft.Common.targets, sauf si la propriété ImportDirectoryBuildTargets a la valeur false. Pour plus d’informations, consultez Personnaliser votre build.

Voir aussi