Propriétés réservées et connues de MSBuild
MSBuild fournit un ensemble de propriétés prédéfinies qui stockent les informations relatives au fichier projet et aux fichiers binaires MSBuild. Ces propriétés sont évaluées de la même manière que les autres propriétés MSBuild. Par exemple, pour utiliser la propriété MSBuildProjectFile, vous devez taper $(MSBuildProjectFile).
MSBuild utilise les valeurs du tableau ci-dessous pour prédéfinir les propriétés réservées et connues. Les propriétés réservées ne peuvent pas être remplacées. De plus, la plupart des propriétés connues ne doivent pas être remplacées, sauf dans les scénarios avancés.
Propriétés réservées et connues
Le tableau de cette section montre les propriétés prédéfinies MSBuild. L’exemple de colonne du tableau est lié à l’exemple de fichier projet suivant, censé se trouver sur C:\Source\Repos\ConsoleApp1\ConsoleApp1. Il montre un exemple des valeurs que présentent ces propriétés quand elles sont utilisées dans le fichier projet, quand MSBuild est appelé sans options de ligne de commande particulières.
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>netcoreapp3.1</TargetFramework>
</PropertyGroup>
</Project>
| Propriété | Réservée ou connue | Description | Exemple |
|---|---|---|---|
FrameworkSDKRoot |
Connue | Chemin du dossier racine des outils du .NET Framework. | C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\ |
InnerBuildProperty |
Connue | Spécifie le nom de propriété qui définit la dimension de build de multiciblage (applicable uniquement si la build actuelle est une build de graphe). | TargetFramework |
InnerBuildPropertyValues |
Connue | Spécifie le nom de propriété qui contient les valeurs possibles pour InnerBuildProperty (applicable uniquement si la build actuelle est une build de graphe). |
TargetFrameworks |
IsGraphBuild |
Connue | True s’il s’agit d’une build de graphe ; en d’autres termes, l’option -graphBuild est effective. Cette option signifie que MSBuild construit et génère un graphe de projet. La construction d’un graphe implique l’identification des références de projet pour les dépendances de formulaire. La création de ce graphe implique de tenter de générer des références de projet avant les projets qui les référencent, ce qui diffère de la planification MSBuild classique. |
|
MSBuildAssemblyVersion |
Réservé | Version des assemblys MSBuild utilisés pour générer le projet. | 16,0 |
MSBuildBinPath |
Réservé | Chemin absolu du dossier où se trouvent les fichiers binaires MSBuild utilisés (par exemple C:\Windows\Microsoft.Net\Framework\<numéroVersion>). Cette propriété est utile si vous devez faire référence à des fichiers du répertoire MSBuild. N'incluez pas la barre oblique inverse finale dans cette propriété. |
C:\Program Files (x86)\Microsoft Visual Studio\2019\MSBuild\Current\Bin |
MSBuildDisableFeaturesFromVersion |
Réservé | Utilisé par les SDK Microsoft et MSBuild pour gérer les vagues de changements. | |
MSBuildExtensionsPath |
Connue | Introduite pour la première fois dans .NET Framework 4 : il n'existe aucune différence entre les valeurs par défaut de MSBuildExtensionsPath et de MSBuildExtensionsPath32. Vous pouvez affecter à la variable d'environnement MSBUILDLEGACYEXTENSIONSPATH une valeur non null pour activer le comportement de la valeur par défaut de MSBuildExtensionsPath dans les versions antérieures.Dans le .NET Framework 3.5 et les versions antérieures, la valeur par défaut de MSBuildExtensionsPath pointe vers le chemin du sous-dossier MSBuild situé dans le dossier \Program Files\ ou \Program Files (x86), en fonction du nombre de bits du processus actuel. Par exemple, pour un processus 32 bits sur un ordinateur 64 bits, la propriété pointe vers le dossier \Program Files (x86). Pour un processus 64 bits sur un ordinateur 64 bits, la propriété pointe vers le dossier \Program Files.N'incluez pas la barre oblique inverse finale dans cette propriété. Cet emplacement est utile pour placer les fichiers cibles personnalisés. Par exemple, vos fichiers cibles peuvent être installés dans \Program Files\MSBuild\MyFiles\Northwind.targets, puis importés dans les fichiers projet à l’aide du code XML suivant : <Import Project="$(MSBuildExtensionsPath)\MyFiles\Northwind.targets"/> |
C:\Program Files (x86)\Microsoft Visual Studio\2019\MSBuild |
MSBuildExtensionsPath32 |
Connue | Chemin du sous-dossier MSBuild dans le dossier \Program Files ou \Program Files (x86). Le chemin d’accès pointe toujours vers le dossier \Program Files (x86) 32 bits sur un ordinateur 32 bits et vers le dossier \Program Files sur un ordinateur 64 bits. Consultez également MSBuildExtensionsPath et MSBuildExtensionsPath64.N'incluez pas la barre oblique inverse finale dans cette propriété. |
C:\Program Files (x86)\Microsoft Visual Studio\2019\MSBuild |
MSBuildExtensionsPath64 |
Connue | Chemin du sous-dossier MSBuild dans le dossier \Program Files. Pour un ordinateur 64 bits, ce chemin pointe toujours vers le dossier \Program Files. Pour un ordinateur 32 bits, ce chemin d'accès est vierge. Consultez également MSBuildExtensionsPath et MSBuildExtensionsPath32.N'incluez pas la barre oblique inverse finale dans cette propriété. |
C:\Program Files\MSBuild |
MSBuildFileVersion |
Réservé | Version en 4 parties des assemblys MSBuild utilisés pour générer le projet. | 16.11.0.30701 |
MSBuildFrameworkToolsPath |
Connue | Chemin des outils du .NET Framework avec lesquels la version en cours d’exécution de MSBuild a été générée, suivi d’une barre oblique de fin. | C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\ |
MSBuildFrameworkToolsPath32 |
Connue | Chemin de la version 32 bits des outils du .NET Framework correspondant à la même version de framework que celle avec laquelle la version en cours d’exécution de MSBuild a été générée, suivi d’une barre oblique de fin. | C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\ |
MSBuildFrameworkToolsPath64 |
Connue | Chemin de la version 64 bits des outils du .NET Framework correspondant à la même version de framework que celle avec laquelle la version en cours d’exécution de MSBuild a été générée, suivi d’une barre oblique de fin. | C:\WINDOWS\Microsoft.NET\Framework64\v4.0.30319\ |
MSBuildInteractive |
Réservé | true si MSBuild s’exécute de manière interactive, ce qui permet une entrée utilisateur. Ce paramètre est contrôlé par l’option de ligne de commande -interactive. |
false |
MSBuildLastTaskResult |
Réservé | true si la tâche précédente s'est déroulée sans erreur (même avec des avertissements) ou false si la tâche précédente comportait des erreurs. En général, lorsqu'une erreur se produit dans une tâche, l'erreur représente la dernière chose qui se produit dans le projet. Par conséquent, la valeur de cette propriété n'est jamais false, sauf dans les scénarios suivants :- Quand l’attribut ContinueOnError de l’élément Task (MSBuild) est défini sur WarnAndContinue (ou true) ou ErrorAndContinue.- Quand la Target possède un élément OnError (MSBuild) comme élément enfant. |
true |
MSBuildNodeCount |
Réservé | 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ée pour -maxcpucount en ligne de commande. Si vous avez indiqué -maxcpucount sans spécifier de valeur, MSBuildNodeCount spécifie le nombre de processeurs sur l’ordinateur. Pour plus d’informations, voir Informations de référence sur la ligne de commande et Générer plusieurs projets en parallèle. |
1 |
MSBuildOverrideTasksPath |
Connue | Emplacement de recherche de fichiers .overridetasks, qui permettent de fournir des versions personnalisées de tâches standard. Consultez Tâches MSBuild.N'incluez pas la barre oblique inverse finale dans le chemin. |
|
MSBuildProgramFiles32 |
Réservé | Emplacement du dossier du programme 32 bits, par exemple C:\Program Files (x86). N'incluez pas la barre oblique inverse finale dans cette propriété. |
C:\Program Files (x86) |
MSBuildProjectDefaultTargets |
Réservé | Liste complète des cibles qui sont 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" > |
Build |
MSBuildProjectDirectory |
Réservé | Chemin absolu du répertoire contenant le fichier projet, par exemple C:\MyCompany\MyProduct. N'incluez pas la barre oblique inverse finale dans cette propriété. |
C:\Source\Repos\ConsoleApp1\ConsoleApp1 |
MSBuildProjectDirectoryNoRoot |
Réservé | Valeur de la propriété MSBuildProjectDirectory, à l'exclusion du lecteur racine.N'incluez pas la barre oblique inverse finale dans cette propriété. |
Source\Repos\ConsoleApp1\ConsoleApp1 |
MSBuildProjectExtension |
Réservé | Extension de nom du fichier projet, avec le point, par exemple .proj. | .csproj |
MSBuildProjectFile |
Réservé | Nom complet du fichier projet, avec l’extension de nom de fichier, par exemple MyApp.proj. | ConsoleApp1.csproj |
MSBuildProjectFullPath |
Réservé | Chemin absolu et nom complet du fichier projet, avec l’extension de nom de fichier, par exemple C:\MyCompany\MyProduct\MyApp.proj. | c:\Source\Repos\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj |
MSBuildProjectName |
Réservé | Nom du fichier projet sans l’extension de nom de fichier, par exemple MyApp. | ConsoleApp1 |
MSBuildRuntimeType |
Réservé | Type du runtime en cours d’exécution. Introduit dans MSBuild 15. La valeur peut être indéfinie (avant MSBuild 15), Full indiquant que MSBuild s’exécute sur le .NET Framework pour applications de bureau, Core indiquant que MSBuild s’exécute sur .NET Core (par exemple dans dotnet build) ou Mono indiquant que MSBuild s’exécute sur Mono. |
Full |
MSBuildSDKsPath |
Connue | Chemin utilisé par MSBuild pour rechercher les kits SDK. | C:\Program Files (x86)\Microsoft Visual Studio\2019\MSBuild\Sdks |
MSBuildSemanticVersion |
Réservé | Version SemVer 2.0 complète des assemblys MSBuild utilisés pour générer le projet. | 16.11.0-preview-21302-05+5e37cc992 |
MSBuildStartupDirectory |
Réservé | Chemin absolu du dossier où MSBuild est appelé. À l’aide de cette propriété, vous pouvez générer tout ce qui se trouve sous un point spécifique d’une arborescence de projet sans créer de fichiers <dirs>.proj dans chaque répertoire. À la place, vous avez un seul projet, par exemple c:\traversal.proj, comme indiqué ici :<Project ...> <ItemGroup> <ProjectFiles Include="$ (MSBuildStartupDirectory) **\*.csproj"/> </ItemGroup> <Target Name="build"> <MSBuild Projects="@(ProjectFiles)"/> </Target> </Project>Pour générer des éléments en tout point de l'arborescence, tapez : msbuild c:\traversal.projN'incluez pas la barre oblique inverse finale dans cette propriété. |
c:\Source\Repos\ConsoleApp1 |
MSBuildThisFile |
Réservé | Nom de fichier et partie de l'extension de fichier de MSBuildThisFileFullPath. |
ConsoleApp1.csproj |
MSBuildThisFileDirectory |
Réservé | Partie de répertoire de MSBuildThisFileFullPath.Incluez la barre oblique inverse finale dans le chemin. |
c:\Source\Repos\ConsoleApp1\ConsoleApp1\ |
MSBuildThisFileDirectoryNoRoot |
Réservé | Partie de répertoire de MSBuildThisFileFullPath, à l'exclusion du lecteur racine.Incluez la barre oblique inverse finale dans le chemin. |
Source\Repos\ConsoleApp1\ConsoleApp1\ |
MSBuildThisFileExtension |
Réservé | Partie de l'extension du nom de fichier de MSBuildThisFileFullPath. |
.csproj |
MSBuildThisFileFullPath |
Réservé | Chemin d’accès absolu du fichier projet ou de cibles qui contient la cible en cours d’exécution. Conseil : vous pouvez spécifier un chemin d’accès relatif dans un fichier de cibles, qui se rapporte au fichier de cibles et non au fichier projet d’origine. |
c:\Source\Repos\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj |
MSBuildThisFileName |
Réservé | Partie du nom de fichier de MSBuildThisFileFullPath, sans l'extension de nom de fichier. |
ConsoleApp1 |
MSBuildToolsPath |
Réservé | Chemin d’installation de la version de MSBuild associée à la valeur de MSBuildToolsVersion.N'incluez pas la barre oblique inverse finale dans le chemin. Cette propriété ne peut pas être remplacée. |
C:\Program Files (x86)\Microsoft Visual Studio\2019\MSBuild\Current\Bin\ |
MSBuildToolsPath32 |
Connue | Chemin d’installation de la version 32 bits de MSBuild associée à la valeur de MSBuildToolsVersion.N'incluez pas la barre oblique inverse finale dans le chemin. Cette propriété ne peut pas être remplacée. |
C:\Program Files (x86)\Microsoft Visual Studio\2019\MSBuild\Current\Bin |
MSBuildToolsPath64 |
Connue | Chemin d’installation de la version 64 bits de MSBuild associée à la valeur de MSBuildToolsVersion.N'incluez pas la barre oblique inverse finale dans le chemin. Cette propriété ne peut pas être remplacée. |
C:\Program Files (x86)\Microsoft Visual Studio\2019\MSBuild\Current\Bin\amd64 |
MSBuildToolsVersion |
Réservé | Version de l’ensemble d’outils MSBuild utilisé pour générer le projet. Remarque : Un ensemble d’outils MSBuild se compose de tâches, de cibles et d’outils qui sont utilisés pour générer une application. Les outils incluent des compilateurs tels que csc.exe et vbc.exe. Pour plus d’informations, voir Ensemble d’outils (ToolsVersion) et Configurations standard et personnalisées des ensembles d’outils. |
Current |
MSBuildUserExtensionsPath |
Connue | Ce chemin fournit l’emplacement du dossier d’installation de MSBuild. Il peut être réinitialisé pour fournir des personnalisations locales par utilisateur. Consultez Personnaliser votre build locale. N'incluez pas la barre oblique inverse finale dans le chemin. |
|
MSBuildVersion |
Réservé | Version de MSBuild utilisée pour générer le projet. Cette propriété ne peut pas être substituée, sinon le message d’erreur MSB4004 - The 'MSBuildVersion' property is reserved, and can't be modified. est retourné. |
16.11.0 |
MSBuildWarningsAsErrors |
Connue | Liste de codes d’avertissement à traiter en tant qu’erreurs. | MSB1234;MSB5678 |
MSBuildWarningsAsMessages |
Connue | Liste de codes d’avertissement à traiter en tant que messages. | MSB1234;MSB5678 |
MSBuildWarningsNotAsErrors |
Connue | Liste de codes d’avertissement qui ne doivent pas être promus en erreurs, même si le commutateur -warnAsError est défini pour promouvoir tous les autres avertissements en erreurs. Notez que cela n’a aucun effet si ce n’est pas vrai. |
MSB1234;MSB5678 |
OS |
Connue | Sur Windows, cette propriété est héritée du système d’exploitation hôte. Les valeurs possibles sont « Windows_NT » et « Unix » ; ces valeurs peuvent être définies différemment sur des systèmes d’exploitation autres que Windows. | |
RoslynTargetsPath |
Connue | Chemin des compilateurs Roslyn. | C:\Program Files\Microsoft Visual Studio\2019\MSBuild\Current\Bin\Roslyn |
SDK35ToolsPath |
Connue | Chemin des outils .NET Framework 3.5. | |
SDK40ToolsPath |
Connue | Chemin des outils .NET Framework 4.0. | C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.8 Tools\ |
VsInstallRoot |
Connue | Dossier d’installation de Visual Studio. | C:\Program Files (x86)\Microsoft Visual Studio\2019 |
WindowsSDK80Path |
Connue |
| Propriété | Réservée ou connue | Description | Exemple |
|---|---|---|---|
FrameworkSDKRoot |
Connue | Chemin du dossier racine des outils du .NET Framework. | C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\ |
InnerBuildProperty |
Connue | Spécifie le nom de propriété qui définit la dimension de build de multiciblage (applicable uniquement si la build actuelle est une build de graphe). | TargetFramework |
InnerBuildPropertyValues |
Connue | Spécifie le nom de propriété qui contient les valeurs possibles pour InnerBuildProperty (applicable uniquement si la build actuelle est une build de graphe). |
TargetFrameworks |
IsGraphBuild |
Connue | True s’il s’agit d’une build de graphe ; en d’autres termes, l’option -graphBuild est effective. Cette option signifie que MSBuild construit et génère un graphe de projet. La construction d’un graphe implique l’identification des références de projet pour les dépendances de formulaire. La création de ce graphe implique de tenter de générer des références de projet avant les projets qui les référencent, ce qui diffère de la planification MSBuild classique. |
|
MSBuildAssemblyVersion |
Réservé | Version des assemblys MSBuild utilisés pour générer le projet. | 17.0 |
MSBuildBinPath |
Réservé | Chemin absolu du dossier où se trouvent les fichiers binaires MSBuild utilisés (par exemple C:\Windows\Microsoft.Net\Framework\<numéroVersion>). Cette propriété est utile si vous devez faire référence à des fichiers du répertoire MSBuild. N'incluez pas la barre oblique inverse finale dans cette propriété. |
C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\amd64 |
MSBuildDisableFeaturesFromVersion |
Réservé | Utilisé par les SDK Microsoft et MSBuild pour gérer les vagues de changements. | |
MSBuildExtensionsPath |
Connue | Introduite pour la première fois dans .NET Framework 4 : il n'existe aucune différence entre les valeurs par défaut de MSBuildExtensionsPath et de MSBuildExtensionsPath32. Vous pouvez affecter à la variable d'environnement MSBUILDLEGACYEXTENSIONSPATH une valeur non null pour activer le comportement de la valeur par défaut de MSBuildExtensionsPath dans les versions antérieures.Dans le .NET Framework 3.5 et les versions antérieures, la valeur par défaut de MSBuildExtensionsPath pointe vers le chemin du sous-dossier MSBuild situé dans le dossier \Program Files\ ou \Program Files (x86), en fonction du nombre de bits du processus actuel. Par exemple, pour un processus 32 bits sur un ordinateur 64 bits, la propriété pointe vers le dossier \Program Files (x86). Pour un processus 64 bits sur un ordinateur 64 bits, la propriété pointe vers le dossier \Program Files.N'incluez pas la barre oblique inverse finale dans cette propriété. Cet emplacement est utile pour placer les fichiers cibles personnalisés. Par exemple, vos fichiers cibles peuvent être installés dans \Program Files\MSBuild\MyFiles\Northwind.targets, puis importés dans les fichiers projet à l’aide du code XML suivant : <Import Project="$(MSBuildExtensionsPath)\MyFiles\Northwind.targets"/> |
C:\Program Files\Microsoft Visual Studio\2022\MSBuild |
MSBuildExtensionsPath32 |
Connue | Chemin du sous-dossier MSBuild dans le dossier \Program Files ou \Program Files (x86). Le chemin d’accès pointe toujours vers le dossier \Program Files (x86) 32 bits sur un ordinateur 32 bits et vers le dossier \Program Files sur un ordinateur 64 bits. Consultez également MSBuildExtensionsPath et MSBuildExtensionsPath64.N'incluez pas la barre oblique inverse finale dans cette propriété. |
C:\Program Files\Microsoft Visual Studio\2022\MSBuild |
MSBuildExtensionsPath64 |
Connue | Chemin du sous-dossier MSBuild dans le dossier \Program Files. Pour un ordinateur 64 bits, ce chemin pointe toujours vers le dossier \Program Files. Pour un ordinateur 32 bits, ce chemin d'accès est vierge. Consultez également MSBuildExtensionsPath et MSBuildExtensionsPath32.N'incluez pas la barre oblique inverse finale dans cette propriété. |
C:\Program Files\MSBuild |
MSBuildFileVersion |
Réservé | Version en 4 parties des assemblys MSBuild utilisés pour générer le projet. | 17.4.0.46505 |
MSBuildFrameworkToolsPath |
Connue | Chemin des outils du .NET Framework avec lesquels la version en cours d’exécution de MSBuild a été générée, suivi d’une barre oblique de fin. | C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\ |
MSBuildFrameworkToolsPath32 |
Connue | Chemin de la version 32 bits des outils du .NET Framework correspondant à la même version de framework que celle avec laquelle la version en cours d’exécution de MSBuild a été générée, suivi d’une barre oblique de fin. | C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\ |
MSBuildFrameworkToolsPath64 |
Connue | Chemin de la version 64 bits des outils du .NET Framework correspondant à la même version de framework que celle avec laquelle la version en cours d’exécution de MSBuild a été générée, suivi d’une barre oblique de fin. | C:\WINDOWS\Microsoft.NET\Framework64\v4.0.30319\ |
MSBuildInteractive |
Réservé | true si MSBuild s’exécute de manière interactive, ce qui permet une entrée utilisateur. Ce paramètre est contrôlé par l’option de ligne de commande -interactive. |
false |
MSBuildLastTaskResult |
Réservé | true si la tâche précédente s'est déroulée sans erreur (même avec des avertissements) ou false si la tâche précédente comportait des erreurs. En général, lorsqu'une erreur se produit dans une tâche, l'erreur représente la dernière chose qui se produit dans le projet. Par conséquent, la valeur de cette propriété n'est jamais false, sauf dans les scénarios suivants :- Quand l’attribut ContinueOnError de l’élément Task (MSBuild) est défini sur WarnAndContinue (ou true) ou ErrorAndContinue.- Quand la Target possède un élément OnError (MSBuild) comme élément enfant. |
true |
MSBuildNodeCount |
Réservé | 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ée pour -maxcpucount en ligne de commande. Si vous avez indiqué -maxcpucount sans spécifier de valeur, MSBuildNodeCount spécifie le nombre de processeurs sur l’ordinateur. Pour plus d’informations, voir Informations de référence sur la ligne de commande et Générer plusieurs projets en parallèle. |
1 |
MSBuildOverrideTasksPath |
Connue | Emplacement de recherche de fichiers .overridetasks, qui permettent de fournir des versions personnalisées de tâches standard. Consultez Tâches MSBuild.N'incluez pas la barre oblique inverse finale dans le chemin. |
|
MSBuildProgramFiles32 |
Réservé | Emplacement du dossier du programme 32 bits, par exemple C:\Program Files (x86). N'incluez pas la barre oblique inverse finale dans cette propriété. |
C:\Program Files (x86) |
MSBuildProjectDefaultTargets |
Réservé | Liste complète des cibles qui sont 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" > |
Build |
MSBuildProjectDirectory |
Réservé | Chemin absolu du répertoire contenant le fichier projet, par exemple C:\MyCompany\MyProduct. N'incluez pas la barre oblique inverse finale dans cette propriété. |
C:\Source\Repos\ConsoleApp1\ConsoleApp1 |
MSBuildProjectDirectoryNoRoot |
Réservé | Valeur de la propriété MSBuildProjectDirectory, à l'exclusion du lecteur racine.N'incluez pas la barre oblique inverse finale dans cette propriété. |
Source\Repos\ConsoleApp1\ConsoleApp1 |
MSBuildProjectExtension |
Réservé | Extension de nom du fichier projet, avec le point, par exemple .proj. | .csproj |
MSBuildProjectFile |
Réservé | Nom complet du fichier projet, avec l’extension de nom de fichier, par exemple MyApp.proj. | ConsoleApp1.csproj |
MSBuildProjectFullPath |
Réservé | Chemin absolu et nom complet du fichier projet, avec l’extension de nom de fichier, par exemple C:\MyCompany\MyProduct\MyApp.proj. | c:\Source\Repos\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj |
MSBuildProjectName |
Réservé | Nom du fichier projet sans l’extension de nom de fichier, par exemple MyApp. | ConsoleApp1 |
MSBuildRuntimeType |
Réservé | Type du runtime en cours d’exécution. Introduit dans MSBuild 15. La valeur peut être indéfinie (avant MSBuild 15), Full indiquant que MSBuild s’exécute sur le .NET Framework pour applications de bureau, Core indiquant que MSBuild s’exécute sur .NET Core (par exemple dans dotnet build) ou Mono indiquant que MSBuild s’exécute sur Mono. |
Full |
MSBuildStartupDirectory |
Réservé | Chemin absolu du dossier où MSBuild est appelé. À l’aide de cette propriété, vous pouvez générer tout ce qui se trouve sous un point spécifique d’une arborescence de projet sans créer de fichiers <dirs>.proj dans chaque répertoire. À la place, vous avez un seul projet, par exemple c:\traversal.proj, comme indiqué ici :<Project ...> <ItemGroup> <ProjectFiles Include="$ (MSBuildStartupDirectory) **\*.csproj"/> </ItemGroup> <Target Name="build"> <MSBuild Projects="@(ProjectFiles)"/> </Target> </Project>Pour générer des éléments en tout point de l'arborescence, tapez : msbuild c:\traversal.projN'incluez pas la barre oblique inverse finale dans cette propriété. |
c:\Source\Repos\ConsoleApp1 |
MSBuildThisFile |
Réservé | Nom de fichier et partie de l'extension de fichier de MSBuildThisFileFullPath. |
ConsoleApp1.csproj |
MSBuildThisFileDirectory |
Réservé | Partie de répertoire de MSBuildThisFileFullPath.Incluez la barre oblique inverse finale dans le chemin. |
c:\Source\Repos\ConsoleApp1\ConsoleApp1\ |
MSBuildThisFileDirectoryNoRoot |
Réservé | Partie de répertoire de MSBuildThisFileFullPath, à l'exclusion du lecteur racine.Incluez la barre oblique inverse finale dans le chemin. |
Source\Repos\ConsoleApp1\ConsoleApp1\ |
MSBuildThisFileExtension |
Réservé | Partie de l'extension du nom de fichier de MSBuildThisFileFullPath. |
.csproj |
MSBuildThisFileFullPath |
Réservé | Chemin d’accès absolu du fichier projet ou de cibles qui contient la cible en cours d’exécution. Conseil : vous pouvez spécifier un chemin d’accès relatif dans un fichier de cibles, qui se rapporte au fichier de cibles et non au fichier projet d’origine. |
c:\Source\Repos\ConsoleApp1\ConsoleApp1\ConsoleApp1.csproj |
MSBuildThisFileName |
Réservé | Partie du nom de fichier de MSBuildThisFileFullPath, sans l'extension de nom de fichier. |
ConsoleApp1 |
MSBuildToolsPath |
Réservé | Chemin d’installation de la version de MSBuild associée à la valeur de MSBuildToolsVersion.N'incluez pas la barre oblique inverse finale dans le chemin. Cette propriété ne peut pas être remplacée. |
C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\amd64 |
MSBuildToolsPath32 |
Connue | Chemin d’installation de la version 32 bits de MSBuild associée à la valeur de MSBuildToolsVersion.N'incluez pas la barre oblique inverse finale dans le chemin. Cette propriété ne peut pas être remplacée. |
C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin |
MSBuildToolsPath64 |
Connue | Chemin d’installation de la version 64 bits de MSBuild associée à la valeur de MSBuildToolsVersion.N'incluez pas la barre oblique inverse finale dans le chemin. Cette propriété ne peut pas être remplacée. |
C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\amd64 |
MSBuildToolsVersion |
Réservé | Version de l’ensemble d’outils MSBuild utilisé pour générer le projet. Remarque : Un ensemble d’outils MSBuild se compose de tâches, de cibles et d’outils qui sont utilisés pour générer une application. Les outils incluent des compilateurs tels que csc.exe et vbc.exe. Pour plus d’informations, voir Ensemble d’outils (ToolsVersion) et Configurations standard et personnalisées des ensembles d’outils. |
Current |
MSBuildSDKsPath |
Connue | Chemin utilisé par MSBuild pour rechercher les kits SDK. | C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Sdks |
MSBuildSemanticVersion |
Réservé | Version SemVer 2.0 complète des assemblys MSBuild utilisés pour générer le projet. | 17.4.0-preview-22465-05+6033e4c95 |
MSBuildUserExtensionsPath |
Connue | Ce chemin fournit l’emplacement du dossier d’installation de MSBuild. Il peut être réinitialisé pour fournir des personnalisations locales par utilisateur. Consultez Personnaliser votre build locale. N'incluez pas la barre oblique inverse finale dans le chemin. |
|
MSBuildVersion |
Réservé | Version de MSBuild utilisée pour générer le projet. Cette propriété ne peut pas être substituée, sinon le message d’erreur MSB4004 - The 'MSBuildVersion' property is reserved, and can't be modified. est retourné. |
17.4.0 |
MSBuildWarningsAsErrors |
Connue | Liste de codes d’avertissement à traiter en tant qu’erreurs. | MSB1234;MSB5678 |
MSBuildWarningsAsMessages |
Connue | Liste de codes d’avertissement à traiter en tant que messages. | MSB1234;MSB5678 |
MSBuildWarningsNotAsErrors |
Connue | Liste de codes d’avertissement qui ne doivent pas être promus en erreurs, même si le commutateur -warnAsError est défini pour promouvoir tous les autres avertissements en erreurs. Notez que cela n’a aucun effet si ce n’est pas vrai. |
MSB1234;MSB5678 |
OS |
Connue | Sur Windows, cette propriété est héritée du système d’exploitation hôte. Les valeurs possibles sont « Windows_NT » et « Unix » ; ces valeurs peuvent être définies différemment sur des systèmes d’exploitation autres que Windows. | |
RoslynTargetsPath |
Connue | Chemin des cibles pour les compilateurs Roslyn. | C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\Roslyn |
SDK35ToolsPath |
Connue | Chemin des outils .NET Framework 3.5. | |
SDK40ToolsPath |
Connue | Chemin des outils .NET Framework 4.0. | C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.8 Tools\ |
VsInstallRoot |
Connue | Dossier d’installation de Visual Studio. | C:\Program Files\Microsoft Visual Studio\2022 |
WindowsSDK80Path |
Connue | Chemin du kit SDK Windows 8. |
Propriétés spécifiques aux projets C++
Les propriétés suivantes représentent le chemin des fichiers d’importation MSBuild C++, par exemple les fichiers .props et .targets, pour les différentes versions de l’ensemble d’outils C++ et les différents systèmes d’exploitation cibles. Les fichiers de ces dossiers représentent l’infrastructure de build C++ et sont essentiels à la génération de tout projet C++ avec MSBuild.
| Propriété | Réservée ou connue | Description | Exemple |
|---|---|---|---|
AndroidTargetsPath |
Connue | Chemin des fichiers d’importation MSBuild C++ pour les builds Android. | C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Microsoft\MDD\Android\V150\ |
iOSTargetsPath |
Connue | Chemin des fichiers d’importation MSBuild C++ pour les builds iOS. | C:\Program Files\Microsoft Visual Studio\2022\Preview\MSBuild\Microsoft\MDD\iOS\V150\ |
VCTargetsPath |
Connue | Chemin des fichiers MSBuild C++ qui prennent en charge le système de build C++. | C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Microsoft\VC\v170\ |
VCTargetsPath10 |
Connue | Chemin des fichiers MSBuild C++ qui prennent en charge l’ensemble d’outils Visual Studio 2010. | C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\ |
VCTargetsPath11 |
Connue | Chemin des fichiers d’importation MSBuild pour l’ensemble d’outils Visual Studio 2012 (V110). | C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V110\ |
VCTargetsPath12 |
Connue | Chemin des fichiers d’importation MSBuild pour l’ensemble d’outils Visual Studio 2013 (V120). | C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V120\ |
VCTargetsPath14 |
Connue | Chemin des fichiers d’importation MSBuild pour l’ensemble d’outils Visual Studio 2015 (V140). | C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V140\ |
Noms en conflit avec des éléments MSBuild
En plus des éléments ci-dessus, les noms correspondant à des éléments de langage MSBuild ne peuvent pas être utilisés pour des propriétés, des éléments ou des métadonnées d’élément définis par l’utilisateur :
- VisualStudioProject
- Cible
- PropertyGroup
- Sortie
- ItemGroup
- UsingTask
- ProjectExtensions
- OnError
- ImportGroup
- Choose
- Lorsque le répertoire
- Otherwise