MSBuild, propriétés réservées
MSBuild fournit un jeu de propriétés réservées pour stocker des informations sur le fichier projet et les binaires MSBuild.Ces propriétés sont évaluées de la même manière que d'autres propriétés d' MSBuild .Par exemple, pour utiliser la propriété MSBuildProjectFile, vous devez taper ce qui suit :
$(MSBuildProjectFile)
Propriétés réservées
Le tableau suivant décrit les propriétés réservées MSBuild.
Propriété |
Description |
|---|---|
MSBuildBinPath |
Le chemin d'accès absolu du dossier où les binaires de MSBuild actuellement sont utilisés sont localisés (par exemple, C:\Windows\Microsoft.Net infrastructurenuméroversion\\\).Cette propriété est utile si vous devez faire référence à des fichiers dans le répertoire MSBuild. |
MSBuildExtensionsPath |
Chemin de MSBuild sous-dossier sous\fichier programme ou\\ fichier programme) (x86\dossier, selon le nombre de bits de la fenêtre active.Par exemple, pour de 32 bits fenêtre sur 64 bits ordinateur, point de trajectoire à\fichier programme) (x86\dossier.Pour une fenêtre 64 bits sur un ordinateur 64 bits, les points de trajectoire au \Program Files\ dossier.Consultez également MSBuildExtensionsPath32 et MSBuildExtensionsPath64. Cet emplacement est utile pour stocker les fichiers cibles personnalisés.Par exemple, vos fichiers cibles peuvent être installés à \Program Files\MSBuild\MyFiles\Northwind.targets et ensuite être importés dans les fichiers projet à l'aide de ce code XML : <Import Project="$(MSBuildExtensionsPath)\MyFiles\Northwind.targets"/> .gif "Remarque") Remarque
Vous pouvez définir la variable d'environnement MSBUILDLEGACYEXTENSIONSPATH à une valeur non null pour activer le comportement d' MSBuildExtensionsPath dans les versions antérieures.
|
MSBuildExtensionsPath32 |
Chemin de MSBuild sous-dossier sous\fichier programme ou\\ fichier programme) (x86\dossier.Ce chemin d'accès toujours point valeur de 32 bits\fichier programme\dossier sur de 32 bits ordinateur et\fichier programme) (x86\sur un ordinateur 64 bits.Consultez également MSBuildExtensionsPath et MSBuildExtensionsPath64. |
MSBuildExtensionsPath64 |
Le chemin d'accès du sous-dossier d' MSBuild sous \Program Files\ dossier.Pour un ordinateur 64 bits, points de ce chemin d'accès toujours au \Program Files\ dossier.Pour un ordinateur 32 bits, ce chemin d'accès est vierge.Consultez également MSBuildExtensionsPath et MSBuildExtensionsPath32. |
MSBuildLastTaskResult |
true si la tâche précédente ne se terminait sans erreur (même si elle existait des avertissements), ou false si la tâche précédente a des erreurs. Remarque
En général, lorsqu'une erreur se produit dans une tâche, l'erreur est la dernière opération qui se produit dans ce projet.Par conséquent, la valeur de cette propriété n'est jamais false, sauf dans les scénarios suivants :
|
MSBuildNodeCount |
Le nombre maximal de processus simultanés utilisés lors de la génération.Il s'agit de la valeur que vous avez spécifié pour /maxcpucount sur la ligne de commande.Si vous /maxcpucount spécifié sans spécifier de valeur, puis MSBuildNodeCount spécifie le nombre de processeurs de l'ordinateur.Pour plus d'informations, consultez Référence de la ligne de commande MSBuild et Génération parallèle de plusieurs projets avec MSBuild. |
MSBuildProgramFiles32 |
L'emplacement du dossier du programme de 32 bits ; par exemple, C:\Program Files (x86). |
MSBuildProjectDefaultTargets |
Liste complète des cibles qui sont spécifiées dans l'attribut DefaultTargets de l'élément Project.Par exemple, l'élément suivant de Project aurait une valeur de propriété d' MSBuildDefaultTargets d' A;B;C: <Project DefaultTargets="A;B;C" > |
MSBuildProjectDirectory |
Le chemin d'accès absolu du dossier dans lequel le fichier projet se trouve ; par exemple, C:\MyCompany\MyProduct\. |
MSBuildProjectDirectoryNoRoot |
La valeur de la propriété d' MSBuildProjectDirectory, à l'exception de le lecteur racine. |
MSBuildProjectExtension |
L'extension de nom de fichier du fichier projet, notamment la période ; par exemple, .proj. |
MSBuildProjectFile |
Le nom de fichier complet du fichier projet, notamment l'extension de nom de fichier ; par exemple, MyApp.proj. |
MSBuildProjectFullPath |
Le chemin d'accès absolu et le nom de fichier complet du fichier projet, notamment l'extension de nom de fichier ; par exemple, C:\MyCompany\MyProduct\MyApp.proj. |
MSBuildProjectName |
Le nom du fichier projet sans l'extension de nom de fichier ; par exemple, MyApp. |
MSBuildStartupDirectory |
Le chemin d'accès absolu du dossier où MSBuild est appelé.En utilisant cette propriété, vous pouvez générer tout en dessous d'un point spécifique dans une arborescence du projet sans créer des fichiers de dirs.proj dans chaque dossier.À la place, vous venez d'un projet- pour l'exemple, c:\traversal.proj, comme indiqué ci-après : Pour générer à tout moment dans l'arborescence, tapez : |
MSBuildThisFile |
La partie de nom de fichier et l'extension de fichier d' MSBuildThisFileFullPath. |
MSBuildThisFileDirectory |
La partie du répertoire d' MSBuildThisFileFullPath. |
MSBuildThisFileDirectoryNoRoot |
La partie du répertoire d' MSBuildThisFileFullPath, à l'exception de le lecteur racine. |
MSBuildThisFileExtension |
L'extension de nom de fichier d' MSBuildThisFileFullPath. |
MSBuildThisFileFullPath |
Le chemin d'accès absolu du fichier de projet ou de cibles qui contient la cible qui exécute. Conseil
La propriété d' MSBuildThisFileFullPath active la spécification d'un chemin d'accès relatif dans un fichier de cibles qui est relatif au fichier de cibles et pas relatif au fichier de projet d'origine.
|
MSBuildThisFileName |
La partie de nom de fichier d' MSBuildThisFileFullPath, sans l'extension de nom de fichier. |
MSBuildToolsPath |
Le chemin d'installation de la version d' MSBuild associée à la valeur d' MSBuildToolsVersion. |
MSBuildToolsVersion |
La version de l'ensemble d'outils MSBuild utilisé pour générer le projet. Remarque
Un ensemble d'outils MSBuild se compose des tâches, de cibles, et les outils utilisés pour générer une application.Les outils incluent des compilateurs tels que csc.exe et vbc.exe.Pour plus d'informations, consultez Ensemble d'outils MSBuild (ToolsVersion) et Configurations standard et personnalisée de l'ensemble d'outils.
|