Partager via


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"/>

RemarqueRemarque
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.

RemarqueRemarque
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 :

<Project ...>
    <ItemGroup>
        <ProjectFiles  
           Include="$
           (MSBuildStartupDirectory)
           **\*.csproj"/>
    </ItemGroup>
    <Target Name="build">
        <MSBuild    
        Projects="@(ProjectFiles)"/>
    </Target>
</Project>

Pour générer à tout moment dans l'arborescence, tapez :

msbuild c:\traversal.proj

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.

ConseilConseil
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.

RemarqueRemarque
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.

Voir aussi

Concepts

Propriétés MSBuild

Autres ressources

Référence MSBuild