Partage via

Propriétés courantes du projet MSBuild

  • Article

Le tableau suivant répertorie les propriétés fréquemment utilisées qui sont définies dans les fichiers projet Visual Studio ou incluses dans .targets fichiers fournis par MSBuild.

Les fichiers projet dans Visual Studio (.csproj, .vbproj, .vcxprojet autres) contiennent du code XML MSBuild qui s’exécute lorsque vous générez un projet à l’aide de l’IDE. Les projets importent généralement un ou plusieurs .targets fichiers pour définir leur processus de génération. Pour plus d’informations, consultez fichiers MSBuild .targets.

Lorsque vous définissez des valeurs de propriété, gardez à l’esprit que les propriétés communes peuvent être définies, réinitialisées ou utilisées dans un certain nombre de fichiers importés. Par conséquent, il importe où vous définissez une propriété dans votre fichier projet, dans Directory.Build.props, ou dans un autre fichier importé. Si vous définissez une propriété quelque part et que vous n’obtenez pas le résultat attendu, envisagez où et comment la propriété est modifiée ou utilisée dans tous les fichiers importés par votre projet, y compris les importations qui sont ajoutées implicitement lorsque vous utilisez l’attribut Sdk. Consultez Choisir entre ajouter des propriétés à un fichier .props ou .targets. Le prétraitement peut vous aider (consultez l’option de ligne de commande /preprocess ou /pp à référence de ligne de commande MSBuild).

Liste des propriétés et paramètres communs

Nom de propriété ou de paramètre Types de projets Description
AdditionalLibPaths .FILET Spécifie des dossiers supplémentaires dans lesquels les compilateurs doivent rechercher des assemblys de référence.
AddModules .FILET Fait en sorte que le compilateur rend toutes les informations de type des fichiers spécifiés disponibles pour le projet que vous compilez. Cette propriété équivaut au commutateur du compilateur /addModules.
ALToolPath .FILET Chemin d’accès à AL.exe. Cette propriété remplace la version actuelle de AL.exe pour permettre l’utilisation d’une autre version.
ApplicationIcon .FILET Fichier d’icône .ico à transmettre au compilateur pour l’incorporation en tant qu’icône Win32. La propriété équivaut au commutateur du compilateur /win32icon.
ApplicationManifest Tout Spécifie le chemin d’accès du fichier utilisé pour générer des informations de manifeste de contrôle de compte d’utilisateur (UAC) externes. S’applique uniquement aux projets Visual Studio ciblant Windows Vista.

Dans la plupart des cas, le manifeste est incorporé. Toutefois, si vous utilisez le déploiement COM gratuit de l’inscription ou ClickOnce, le manifeste peut être un fichier externe installé avec vos assemblys d’application. Pour plus d’informations, consultez la propriété NoWin32Manifest dans cet article.
AssemblyOriginatorKeyFile .FILET Spécifie le fichier utilisé pour signer l’assembly (.snk ou .pfx) et qui est passé à la tâche ResolveKeySource pour générer la clé réelle utilisée pour signer l’assembly.
AssemblySearchPaths .FILET Liste des emplacements à rechercher pendant la résolution d’assembly de référence au moment de la génération. L’ordre dans lequel les chemins d’accès apparaissent dans cette liste est significatif, car les chemins répertoriés précédemment sont prioritaires sur les entrées ultérieures.
AssemblyName .FILET Nom de l’assembly de sortie final après la génération du projet.
Nom de propriété ou de paramètre Types de projets Description
BaseAddress .FILET Spécifie l’adresse de base de l’assembly de sortie principal. Cette propriété équivaut au commutateur du compilateur /baseaddress.
BaseIntermediateOutputPath Tout Dossier de niveau supérieur dans lequel tous les dossiers de sortie intermédiaires spécifiques à la configuration sont créés. La valeur par défaut est obj\. Le code suivant est un exemple : <BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath>
BaseOutputPath Tout Spécifie le chemin d’accès de base du fichier de sortie. Si elle est définie, MSBuild utilise OutputPath = $(BaseOutputPath)\$(Configuration)\. Exemple de syntaxe : <BaseOutputPath>c:\xyz\bin\</BaseOutputPath>
BuildInParallel Tout Valeur booléenne qui indique si les références de projet sont générées ou nettoyées en parallèle lors de l’utilisation de MSBuild multi-proc. La valeur par défaut est true, ce qui signifie que les projets seront générés en parallèle si le système a plusieurs cœurs ou processeurs.
BuildProjectReferences Tout Valeur booléenne qui indique si les références de projet sont générées par MSBuild. Définissez automatiquement la valeur false si vous créez votre projet dans l’environnement de développement intégré (IDE) visual Studio, true si ce n’est pas le cas. -p:BuildProjectReferences=false pouvez être spécifié sur la ligne de commande pour éviter de vérifier que les projets référencés sont à jour.
Nom de propriété ou de paramètre Types de projets Description
CleanFile Tout Nom du fichier qui sera utilisé comme « cache propre ». Le cache propre est une liste de fichiers générés à supprimer pendant l’opération de nettoyage. Le fichier est placé dans le chemin de sortie intermédiaire par le processus de génération.

Cette propriété spécifie uniquement les noms de fichiers qui n’ont pas d’informations de chemin d’accès.
CodePage .FILET Spécifie la page de codes à utiliser pour tous les fichiers de code source dans la compilation. Cette propriété équivaut au commutateur du compilateur /codepage.
CompilerResponseFile .FILET Fichier de réponse facultatif qui peut être transmis aux tâches du compilateur.
Configuration Tout Configuration que vous créez, généralement Debug ou Release, mais configurable aux niveaux de la solution et du projet.
CscToolPath C# Chemin d’accès de csc.exe, compilateur C#.
CustomAfterMicrosoftCommonTargets Tout Nom d’un fichier projet ou d’un fichier cible à importer automatiquement après l’importation des cibles courantes.
CustomBeforeMicrosoftCommonTargets Tout Nom d’un fichier projet ou d’un fichier cible à importer automatiquement avant l’importation des cibles courantes.
Nom de propriété ou de paramètre Types de projets Description
DéboguerSymbols Tout Valeur booléenne qui indique si les symboles sont générés par la build.

La définition de -p :DebugSymbols=false sur la ligne de commande désactive la génération de la base de données de programme (.pdb) fichiers de symboles.
DebugType Tout Définit le niveau d’informations de débogage que vous souhaitez générer. Les valeurs valides sont « full », « pdbonly », « portable », « embedded » et « none ».
DefineConstants .FILET Définit les constantes du compilateur conditionnel. Les paires symbole/valeur sont séparées par des points-virgules et sont spécifiées à l’aide de la syntaxe dépendante du langage :

C# : symbol1; symbol2

Visual Basic : symbol1 = value1, symbol2 = value2

La propriété équivaut au commutateur du compilateur /define.
DefineDebug Tout Valeur booléenne qui indique si vous souhaitez définir la constante DEBUG.
DefineTrace Tout Valeur booléenne qui indique si vous souhaitez que la constante TRACE soit définie.
DelaySign .FILET Valeur booléenne qui indique si vous souhaitez retarder le signe de l’assembly plutôt que de le signer entièrement.
Déterministe .FILET Valeur booléenne qui indique si le compilateur doit produire des assemblys identiques pour des entrées identiques. Ce paramètre correspond au commutateur /deterministic des compilateurs.
DirectoryBuildPropsPath Tout Spécifie le chemin d’accès au fichier Directory.Build.props ; si elle est définie, cette propriété remplace l’algorithme de recherche par défaut. Consultez Personnaliser votrede build.
DirectoryBuildTargetsPath Tout Spécifie le chemin d’accès au fichier Directory.Build.targets ; si elle est définie, cette propriété remplace l’algorithme de recherche par défaut. Consultez Personnaliser votrede build.
DisableFastUpToDateCheck Tout Valeur booléenne qui s’applique uniquement à Visual Studio. Le gestionnaire de build Visual Studio utilise un processus appelé FastUpToDateCheck pour déterminer si un projet doit être reconstruit pour être à jour. Ce processus est plus rapide que l’utilisation de MSBuild pour déterminer cela. La définition de la propriété DisableFastUpToDateCheck sur true vous permet de contourner le gestionnaire de build Visual Studio et de forcer l’utilisation de MSBuild pour déterminer si le projet est à jour.
DocumentationFile .FILET Nom du fichier généré en tant que fichier de documentation XML. Ce nom inclut uniquement le nom du fichier et n’a pas d’informations de chemin d’accès.
Nom de propriété ou de paramètre Types de projets Description
ErrorReport .FILET Spécifie la façon dont la tâche du compilateur doit signaler des erreurs internes du compilateur. Les valeurs valides sont « prompt », « send » ou « none ». Cette propriété équivaut au commutateur du compilateur /errorreport.
ExcludeDeploymentUrl .FILET La tâche GenerateDeploymentManifest ajoute une balise deploymentProvider au manifeste de déploiement si le fichier projet inclut l’un des éléments suivants :

- UpdateUrl
- InstallUrl
- PublishUrl

Toutefois, à l’aide de ExcludeDeploymentUrl, vous pouvez empêcher l’ajout de la balise deploymentProvider au manifeste de déploiement, même si l’une des URL ci-dessus est spécifiée. Pour ce faire, ajoutez la propriété suivante à votre fichier projet :

<ExcludeDeploymentUrl>true</ExcludeDeploymentUrl>

Remarque : ExcludeDeploymentUrl n’est pas exposé dans l’IDE Visual Studio et ne peut être défini qu’en modifiant manuellement le fichier projet. La définition de cette propriété n’affecte pas la publication dans Visual Studio ; autrement dit, la balise deploymentProvider sera toujours ajoutée à l’URL spécifiée par PublishUrl.
FileAlignment .FILET Spécifie, en octets, où aligner les sections du fichier de sortie. Les valeurs valides sont 512, 1024, 2048, 4096, 8192. Cette propriété équivaut au commutateur du compilateur /filealignment.
FrameworkPathOverride Visual Basic Spécifie l’emplacement de mscorlib.dll et de microsoft.visualbasic.dll. Ce paramètre équivaut au commutateur /sdkpath du compilateur vbc.exe.
GenerateDocumentationFile .FILET Paramètre booléen qui indique si la documentation est générée par la build. Si true, la build génère des informations de documentation et la place dans un fichier .xml avec le nom du fichier exécutable ou de la bibliothèque que la tâche de génération a créée.
GenerateFullPaths C# Générez des chemins complets pour les noms de fichiers en sortie à l’aide de l’option -fullpaths compilateur.
GenerateSerializationAssemblies .FILET Indique si les assemblys de sérialisation XML doivent être générés par SGen.exe, qui peuvent être définis sur activé, automatique ou désactivé. Cette propriété est utilisée pour les assemblys qui ciblent .NET Framework uniquement. Pour générer des assemblys de sérialisation XML pour les assemblys .NET Standard ou .NET Core, référencez la Microsoft.XmlSerializer.Generator package NuGet.
Nom de propriété ou de paramètre Types de projets Description
ImportDirectoryBuildProps Tout Valeur booléenne qui indique s’il faut importer un fichier Directory.Build.props. Consultez Personnaliser votrede build.
ImportDirectoryBuildTargets Tout Valeur booléenne qui indique s’il faut importer un fichier Directory.Build.targets. Consultez Personnaliser votrede build.
IntermediateOutputPath Tout Chemin de sortie intermédiaire complet dérivé de BaseIntermediateOutputPath, si aucun chemin n’est spécifié. Par exemple, obj\debug\.
KeyContainerName Tout Nom du conteneur de clé de nom fort.
KeyOriginatorFile Tout Nom du fichier de clé de nom fort.
ModuleAssemblyName .FILET Nom de l’assembly dans lequel le module compilé doit être incorporé. La propriété équivaut au commutateur du compilateur /moduleassemblyname.
MSBuildProjectExtensionsPath Tout Spécifie le chemin d’accès où se trouvent les extensions de projet. Par défaut, cela prend la même valeur que BaseIntermediateOutputPath.
MSBuildTreatWarningsAsErrors Tout Valeur booléenne qui indique à MSBuild de traiter tous les avertissements comme des erreurs, sauf s’ils sont supprimés.
MSBuildWarningsAsErrors Tout Spécifie une liste de codes d’avertissement à traiter comme des erreurs. Séparez plusieurs avertissements par des points-virgules. Si vous utilisez la propriété du Kit de développement logiciel (SDK) .NET WarningsAsErrors, MSBuildWarningsAsErrors a la valeur par défaut de WarningsAsErrors.
MSBuildWarningsAsMessages Tout Spécifie une liste de codes d’avertissement à supprimer en les traitant comme des messages d’importance faible. Séparez plusieurs avertissements par des points-virgules. Notez que certains avertissements émis par MSBuild ne peuvent pas être supprimés à l’aide de cette propriété ; pour les supprimer, utilisez le commutateur de ligne de commande -warnAsMessage. Si vous utilisez la propriété du Kit de développement logiciel (SDK) .NET NoWarn, MSBuildWarningsAsMessages a la valeur par défaut de NoWarn.
Nom de propriété ou de paramètre Types de projets Description
NoLogo Tout Valeur booléenne qui indique si vous souhaitez que le logo du compilateur soit désactivé. Cette propriété équivaut au commutateur du compilateur /nologo.
NoStdLib .FILET Valeur booléenne qui indique s’il faut éviter de référencer la bibliothèque standard (mscorlib.dll). La valeur par défaut est false.
NoVBRuntimeReference Visual Basic Valeur booléenne qui indique si le runtime Visual Basic (Microsoft.VisualBasic.dll) doit être inclus comme référence dans le projet.
NoWarn .FILET Supprime les avertissements spécifiés. Seule la partie numérique de l’identificateur d’avertissement doit être spécifiée. Plusieurs avertissements sont séparés par des points-virgules. Ce paramètre correspond au commutateur /nowarn des compilateurs.
NoWin32Manifest .FILET Valeur booléenne qui indique si les informations de manifeste du contrôle de compte d’utilisateur (UAC) seront incorporées dans l’exécutable de l’application. S’applique uniquement aux projets Visual Studio ciblant Windows Vista. Dans les projets déployés à l’aide de ClickOnce et Registration-Free COM, cet élément est ignoré. False (valeur par défaut) spécifie que les informations de manifeste de contrôle de compte d’utilisateur (UAC) doivent être incorporées dans l’exécutable de l’application. True spécifie que les informations du manifeste UAC ne sont pas incorporées.

Cette propriété s’applique uniquement aux projets Visual Studio ciblant Windows Vista. Dans les projets déployés à l’aide de ClickOnce et Registration-Free COM, cette propriété est ignorée.

Vous devez ajouter NoWin32Manifest uniquement si vous ne souhaitez pas que Visual Studio incorpore des informations de manifeste dans l’exécutable de l’application ; ce processus est appelé virtualisation. Pour utiliser la virtualisation, définissez <ApplicationManifest> conjointement avec <NoWin32Manifest> comme suit :

- Pour les projets Visual Basic, supprimez le nœud <ApplicationManifest>. (Dans les projets Visual Basic, <NoWin32Manifest> est ignoré lorsqu’un nœud <ApplicationManifest> existe.)
- Pour les projets C#, définissez <ApplicationManifest> sur False et <NoWin32Manifest> sur True. (Dans les projets C#, <ApplicationManifest> remplace <NoWin32Manifest>.)
Cette propriété équivaut au commutateur du compilateur /nowin32manifest de vbc.exe.
Optimiser .FILET Valeur booléenne qui, lorsqu’elle est définie sur true, active les optimisations du compilateur. Cette propriété équivaut au commutateur du compilateur /optimize.
OptionCompare VisualBasic Spécifie la façon dont les comparaisons de chaînes sont effectuées. Les valeurs valides sont « binaires » ou « text ». Cette propriété équivaut au commutateur du compilateur /optioncompare de vbc.exe.
OptionExplicit Visual Basic Valeur booléenne qui, lorsqu’elle est définie sur true, nécessite une déclaration explicite de variables dans le code source. Cette propriété équivaut au commutateur du compilateur /optionexplicit.
OptionInfer Visual Basic Valeur booléenne qui, lorsqu’elle est définie sur true, active l’inférence de type des variables. Cette propriété équivaut au commutateur du compilateur /optioninfer.
OptionStrict Visual Basic Valeur booléenne qui, lorsqu’elle est définie sur true, force la tâche de génération à appliquer une sémantique de type stricte pour restreindre les conversions de types implicites. Cette propriété équivaut au commutateur /optionstrict du compilateur vbc.exe.
OutDir Tout Indique l’emplacement de sortie final du projet ou de la solution. Lors de la création d’une solution, OutDir peut être utilisé pour collecter plusieurs sorties de projet dans un emplacement unique. En outre, OutDir est inclus dans AssemblySearchPaths utilisé pour résoudre les références. Par exemple, bin\Debug.
OutputPath Tout Spécifie le chemin d’accès au répertoire de sortie, par rapport au répertoire du projet, par exemple, bin\Debug ou bin\Debug\$(Platform) dans les builds non anyCPU.
OutputType Tout Spécifie le format de fichier du fichier de sortie. Ce paramètre peut avoir l’une des valeurs suivantes :

-Bibliothèque. Crée une bibliothèque de code. (Valeur par défaut.)
- Exe. Crée une application console.
-Module. Crée un module.
- Winexe. Crée un programme Windows.

Pour C# et Visual Basic, cette propriété équivaut au commutateur /target. Le type de sortie peut être remplacé automatiquement par l’inférence. Consultez OutputType défini sur WinExe pour les applications WPF et WinForms. Désactivez l’inférence en définissant DisableWinExeOutputInference sur true.
OverwriteReadOnlyFiles Tout Valeur booléenne qui indique si vous souhaitez activer la génération pour remplacer les fichiers en lecture seule ou déclencher une erreur.
Nom de propriété ou de paramètre Types de projets Description
PathMap .FILET Spécifie comment mapper des chemins physiques aux noms de chemins d’accès source en sortie par le compilateur. Cette propriété équivaut au commutateur /pathmap des compilateurs.
PdbFile .FILET Nom de fichier du fichier .pdb que vous émettez. Cette propriété équivaut au commutateur /pdb du compilateur csc.exe.
Plateforme Tout Le système d’exploitation pour lequel vous créez. Les exemples de builds .NET Framework sont « Any CPU », « x86 » et « x64 ».
ProcessorArchitecture .FILET Architecture du processeur utilisée lorsque les références d’assembly sont résolues. Les valeurs valides sont « msil », « x86 », « amd64 » ou « ia64 ».
ProduceOnlyReferenceAssembly .FILET Valeur booléenne qui indique au compilateur d’émettre uniquement un assembly de référence plutôt que du code compilé. Impossible d’utiliser conjointement avec ProduceReferenceAssembly. Cette propriété correspond au commutateur /refonly des compilateurs vbc.exe et csc.exe.
ProduceReferenceAssembly .FILET Valeur booléenne qui, lorsqu’elle est définie sur true permet de produire des assemblys de référence pour l’assembly actuel. Deterministic doit être true lors de l’utilisation de cette fonctionnalité. Cette propriété correspond au commutateur /refout des compilateurs vbc.exe et csc.exe.
RegisterAssemblyMSBuildArchitecture Windows uniquement Spécifie l’architecture par défaut pour laquelle la DLL managée est inscrite. Cette propriété est utile, car COM utilise le Registre Windows pour stocker les inscriptions dans des ruches spécifiques à l’architecture. Par exemple, sur un système Windows, un assembly managé AnyCPU peut avoir ses types inscrits dans la ruche 64 bits et/ou dans la ruche 32 bits (WoW), et la build utilise cette propriété pour déterminer quelle ruche de Registre spécifique à l’architecture à utiliser. Les valeurs valides incluent « x86 », « x64 » et « ARM64 ».
RegisterForCOMInterop Windows uniquement Indique que votre application managée expose un objet COM (wrapper pouvant être appelé COM). Consultez page Build - Section Sortie. Ce paramètre affecte uniquement l’ordinateur sur lequel le projet est généré. Si vous effectuez un déploiement sur d’autres ordinateurs, appelez regasm.exe pour inscrire l’assembly sur l’ordinateur cible.
RemoveIntegerChecks Visual Basic Valeur booléenne qui indique s’il faut désactiver les vérifications d’erreur de dépassement d’entier. La valeur par défaut est false. Cette propriété équivaut au commutateur /removeintchecks du compilateur vbc.exe.
RootNamespace Tout Espace de noms racine à utiliser lorsque vous nommez une ressource incorporée. Cet espace de noms fait partie du nom du manifeste de ressource incorporé.
Nom de propriété ou de paramètre Types de projets Description
Satellite_AlgorithmId .FILET ID de l’algorithme de hachage AL.exe à utiliser lors de la création d’assemblys satellites.
Satellite_BaseAddress .FILET Adresse de base à utiliser lorsque des assemblys satellites spécifiques à la culture sont générés à l’aide de la cible CreateSatelliteAssemblies.
Satellite_CompanyName .FILET Nom de la société à transmettre à AL.exe pendant la génération d’assembly satellite.
Satellite_Configuration .FILET Nom de configuration à transmettre à AL.exe pendant la génération d’assembly satellite.
Satellite_Description .FILET Texte de description à transmettre à AL.exe pendant la génération d’assembly satellite.
Satellite_EvidenceFile .FILET Incorpore le fichier spécifié dans l’assembly satellite dont le nom de ressource est « Security.Evidence ».
Satellite_FileVersion .FILET Spécifie une chaîne pour le champ Version de fichier dans l’assembly satellite.
Satellite_Flags .FILET Spécifie une valeur pour le champ Indicateurs dans l’assembly satellite.
Satellite_GenerateFullPaths .FILET Provoque l’utilisation de chemins absolus pour tous les fichiers signalés dans un message d’erreur.
Satellite_LinkResource .FILET Lie les fichiers de ressources spécifiés à un assembly satellite.
Satellite_MainEntryPoint .FILET Spécifie le nom complet (c’est-à-dire, class.method) de la méthode à utiliser comme point d’entrée lorsqu’un module est converti en fichier exécutable pendant la génération d’assembly satellite.
Satellite_ProductName .FILET Spécifie une chaîne pour le champ Product dans l’assembly satellite.
Satellite_ProductVersion .FILET Spécifie une chaîne pour le champ ProductVersion dans l’assembly satellite.
Satellite_TargetType .FILET Spécifie le format de fichier du fichier de sortie de l’assembly satellite en tant que « bibliothèque », « exe » ou « win ». La valeur par défaut est « bibliothèque ».
Satellite_Title .FILET Spécifie une chaîne pour le champ Titre dans l’assembly satellite.
Satellite_Trademark .FILET Spécifie une chaîne pour le champ Marque dans l’assembly satellite.
Satellite_Version .FILET Spécifie les informations de version de l’assembly satellite.
Satellite_Win32Icon .FILET Insère un fichier d’icône .ico dans l’assembly satellite.
Satellite_Win32Resource .FILET Insère une ressource Win32 (fichier .res) dans l’assembly satellite.
SGenToolPath .FILET Chemin d’accès d’outil facultatif qui indique où obtenir SGen.exe lorsque la version actuelle de SGen.exe est substituée.
Nom de propriété ou de paramètre Types de projets Description
SGenUseProxyTypes .FILET Valeur booléenne qui indique si les types de proxy doivent être générés par SGen.exe. Cela s’applique uniquement lorsque GenerateSerializationAssemblies est activé.

La cible SGen utilise cette propriété pour définir l’indicateur UseProxyTypes. Cette propriété a la valeur true par défaut et aucune interface utilisateur n’est modifiée. Pour générer l’assembly de sérialisation pour les types de services non web, ajoutez cette propriété au fichier projet et définissez-la sur false avant d’importer les Microsoft.Common.Targets ou les C#/VB.targets.
SkipInvalidConfigurations Tout Lorsque true, générez un avertissement sur des combinaisons de plateforme et de configuration non valides, mais n’échouez pas la build ; quand false ou non défini (valeur par défaut), générez une erreur.
StartupObject .FILET Spécifie la classe ou le module qui contient la méthode Main ou la procédure Sub Main. Cette propriété équivaut au commutateur du compilateur /main.
SubsystemVersion .FILET Spécifie la version minimale du sous-système que le fichier exécutable généré peut utiliser. Cette propriété équivaut au commutateur du compilateur /subsystemversion. Pour plus d’informations sur la valeur par défaut de cette propriété, consultez /subsystemversion (Visual Basic) ou /subsystemversion (options du compilateur C#).
TargetCompactFramework .FILET Version du .NET Compact Framework requise pour exécuter l’application que vous générez. La spécification de ce paramètre vous permet de référencer certains assemblys de framework que vous ne pouvez peut-être pas référencer dans le cas contraire.
TargetFrameworkVersion .FILET Version du .NET Framework requise pour exécuter l’application que vous générez. La spécification de ce paramètre vous permet de référencer certains assemblys de framework que vous ne pouvez peut-être pas référencer dans le cas contraire.
TreatWarningsAsErrors .FILET Paramètre booléen qui, si true, provoque le traitement de tous les avertissements comme des erreurs. Ce paramètre équivaut au commutateur du compilateur /nowarn.
UseCommonOutputDirectory .FILET Propriété booléenne que vous pouvez définir sur true lorsque vous souhaitez que toutes les sorties de build d’une solution utilisent le même répertoire de sortie. Si true, la sortie des projets référencés n’est pas copiée dans les projets qui utilisent ces dépendances, comme c’est le cas normalement lorsque ce paramètre est false. La définition de ce paramètre sur true ne modifie pas le répertoire de sortie réel des projets ; vous devez toujours définir le répertoire de sortie sur le répertoire de sortie commun souhaité pour chaque projet qui en a besoin.
UseHostCompilerIfAvailable .FILET Paramètre booléen qui, si true, provoque l’utilisation de l’objet compilateur in-process, s’il est disponible. Ce paramètre est utilisé uniquement par Visual Studio.
Utf8Output .FILET Paramètre booléen qui, si true, journalise la sortie du compilateur à l’aide de l’encodage UTF-8. Ce paramètre équivaut au commutateur du compilateur /utf8Output.
Nom de propriété ou de paramètre Types de projets Description
VbcToolPath Visual Basic Chemin d’accès facultatif qui indique un autre emplacement pour vbc.exe lorsque la version actuelle de vbc.exe est remplacée.
VbcVerbosity Visual Basic Spécifie la détail de la sortie du compilateur Visual Basic. Les valeurs valides sont « Quiet », « Normal » (valeur par défaut) ou « Verbose ».
VisualStudioVersion Tout Spécifie la version de Visual Studio sous laquelle ce projet doit être considéré comme en cours d’exécution. Si cette propriété n’est pas spécifiée, MSBuild la définit sur une valeur par défaut de {VisualStudioMajorVersion}.0; par exemple, il sera 17.0 pour toutes les versions de Visual Studio 2022.

Cette propriété est utilisée dans plusieurs types de projet pour spécifier l’ensemble de cibles utilisées pour la build. Si ToolsVersion a la valeur 4.0 ou ultérieure pour un projet, VisualStudioVersion est utilisé pour spécifier le sous-ensemble d’outils à utiliser. Pour plus d’informations, consultez Ensemble d’outils (ToolsVersion).
WarningsAsErrors .FILET Spécifie une liste d’avertissements à traiter comme des erreurs. Ce paramètre équivaut au commutateur du compilateur /warnaserror.
WarningLevel Tout Spécifie le niveau d’avertissement à transmettre aux compilateurs pour les avertissements émis par le compilateur. Ce paramètre n’affecte pas les avertissements MSBuild, qui n’ont pas de désignations de niveau. Consultez niveau d’avertissement dans la documentation du compilateur C# et /W (niveau d’avertissement) dans la documentation du compilateur C++.
WarningsNotAsErrors .FILET Spécifie une liste d’avertissements qui ne sont pas traités comme des erreurs. Ce paramètre équivaut au commutateur du compilateur /warnaserror.
Win32Manifest .FILET Nom du fichier manifeste qui doit être incorporé dans l’assembly final. Ce paramètre équivaut au commutateur du compilateur /win32Manifest.
Win32Resource .FILET Nom de fichier de la ressource Win32 à incorporer dans l’assembly final. Ce paramètre équivaut au commutateur du compilateur /win32resource.

Les propriétés propres aux projets du Kit de développement logiciel (SDK) .NET, telles que TargetFramework, sont documentées dans les propriétés de Framework.

Voir aussi