Partager via

MSBuild, propriétés réservées

  • Article

Mise à jour : novembre 2007

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 comme les autres propriétés 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

MSBuildProjectDirectory

Le chemin d'accès absolu du répertoire contenant le fichier projet, par exemple C:\MyCompany\MyProduct.

MSBuildProjectFile

Le nom de fichier complet du fichier projet, y compris l'extension de nom de fichier, par exemple MyApp.proj.

MSBuildProjectExtension

L'extension de nom de fichier du fichier projet, y compris le point, par exemple .proj.

MSBuildProjectFullPath

Le chemin d'accès absolu et le nom de fichier complet du fichier projet, par exemple C:\MyCompany\MyProduct\MyApp.proj.

MSBuildProjectName

Le nom de fichier du fichier projet sans l'extension de nom de fichier, par exemple MyApp.

MSBuildBinPath

Le chemin d'accès absolu du répertoire où les binaires MSBuild utilisés sont localisés actuellement, par exemple, C:\Windows\Microsoft.Net\Framework\v2.0. Cette propriété est utile si vous devez faire référence à des fichiers dans le répertoire MSBuild.

MSBuildProjectDefaultTargets

La liste complète des cibles spécifiées dans l'attribut DefaultTargets de l'élément Project. Par exemple, l'élément Project suivant aurait une valeur de propriété MSBuildDefaultTargets égale à A;B;C.

<Project DefaultTargets="A;B;C" >

MSBuildExtensionsPath

Le dossier MSBuild sous le répertoire Program Files. Cet emplacement est utile pour stocker les fichiers cibles personnalisés. Par exemple, vos fichiers cible peuvent être installés dans \Program Files\MSBuild\MyFiles\Northwind.targets, puis importés dans les fichiers projet avec le XML suivant.

<Import Project="$(MSBuildExtensionsPath)\MyFiles\Northwind.targets"/>

MSBuildStartupDirectory

Le chemin d'accès absolu du répertoire où MSBuild est appelé.

Cela vous permet d'entrer en tout point d'une arborescence du projet et de générer tout ce qui se trouve au-dessous de ce point sans devoir créer de fichiers du type « dirs.proj » dans chaque répertoire. Au lieu de cela, vous avez un projet unique, comme dans cet exemple appelé c:\traversal.proj :

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

Puis, en tout point de l'arborescence, vous n'auriez qu'à taper :

msbuild c:\traversal.proj

Voir aussi

Concepts

Propriétés MSBuild

Autres ressources

Référence MSBuild