Propriétés communes des projets MSBuild

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

Les fichiers projet dans Visual Studio (.csproj, .vbproj, vcxproj, etc.) contiennent le 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 fichiers .targets pour définir leur processus de génération.Pour plus d'informations, consultez Fichiers .Targets MSBuild.

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

Nom de la propriété ou du paramètre	Description
AdditionalLibPaths	Spécifie des dossiers supplémentaires dans lesquels les compilateurs doivent rechercher des assemblys de référence.
AddModules	Entraîne le compilateur à donner des informations de type dans les fichiers spécifiés disponibles pour le projet en cours de compilation.Cette propriété est équivalente au commutateur de compilation /addModules.
ALToolPath	Le chemin d'accès de AL.exe.Cette propriété substitue la version actuelle d'AL.exe pour permettre l'utilisation d'une autre version.
ApplicationIcon	Le fichier icône .ico à passer au compilateur pour qu'il soit incorporé en tant qu'icône Win32.Cette propriété est équivalente au commutateur de compilation /win32icon.
ApplicationManifest	Indique le chemin du fichier utilisé pour générer les informations de manifeste de contrôle de compte d'utilisateur (UAC, User Account Control) externes.S'applique uniquement aux projets Visual Studio ciblant Windows Vista. Dans la plupart des cas, le manifeste est incorporé.Toutefois, si vous utilisez un déploiement COM sans inscription ou ClickOnce, le manifeste peut être un fichier externe installé avec les assemblys de votre application.Pour plus d'informations, consultez la propriété NoWin32Manifest dans cette rubrique.
AssemblyOriginatorKeyFile	Spécifie le fichier utilisé pour signer l'assembly (.snk ou .pfx) et passé à ResolveKeySource, tâche pour générer l'adresse réelle utilisée pour signer l'assembly.
AssemblySearchPaths	Une liste d'emplacements dans lesquels rechercher pour la résolution de références d'assemblys lors de la génération.L'ordre dans lequel les chemins d'accès apparaissent dans cette liste est significatif, car les chemins d'accès précédemment répertoriés ont priorité sur les entrées ultérieures.
AssemblyName	Le nom de l'assembly de sortie définitif après génération du projet.
BaseAddress	Spécifie l'adresse de base de l'assembly de sortie principal.Cette propriété est équivalente au commutateur de compilation /baseaddress.
BaseOutputPath	Spécifie le chemin d'accès de base du fichier de sortie.Si cette valeur est attribuée, MSBuild utilisera OutputPath = $(BaseOutputPath)\$(Configuration)\.Exemple de syntaxe : <BaseOutputPath>c:\xyz\bin\</BaseOutputPath>
BaseIntermediateOutputPath	Le dossier à la racine où 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>
BuildInParallel	Une valeur booléenne qui indique si les références de projet sont générées ou nettoyées en parallèle lorsque MSBuild est utilisé en multiprocesseur.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 possède plusieurs cœurs ou processeurs.
BuildProjectReferences	Une valeur booléenne qui indique si les références de projet sont générées par MSBuild.Attribuez la valeur false si vous générez votre projet dans l'environnement de développement intégré (IDE) Visual Studio, true dans le cas contraire.
CleanFile	Le nom du fichier utilisé comme « nettoyeur de cache ». Ce fichier contient une liste de fichiers générés à supprimer pendant l'opération de nettoyage.Le fichier est mis dans le chemin de sortie intermédiaire par le processus de génération. Cette propriété spécifie uniquement des noms de fichier qui n'ont pas d'informations relatives au chemin d'accès.
CodePage	Spécifie la page de codes à utiliser pour tous les fichiers de code source inclus dans la compilation.Cette propriété est équivalente au commutateur de compilation /codepage.
CompilerResponseFile	Un fichier réponse facultatif qui peut être passé aux tâches du compilateur.
Configuration	La configuration que vous générez, "Debug" ou "Release".
CscToolPath	Le chemin d'accès de csc.exe, le compilateur Visual C#.
CustomBeforeMicrosoftCommonTargets	Le nom d'un fichier projet ou de fichiers cible qui seront automatiquement importés avant l'importation des cibles communes.
DebugSymbols	Une valeur booléenne qui indique si les symboles sont générés lors de la génération. /p:DebugSymbols=false sur la ligne de commande désactive la génération des fichiers de symboles de la base de données (.pdb) de programme.
DefineConstants	Définit des constantes de compilation conditionnelle.Les paires symbole/valeur sont séparées par des points-virgules et spécifiées avec la syntaxe suivante : symbole1 = valeur1 ; symbole2 = valeur2 Cette propriété est équivalente au commutateur de compilation /define.
DefineDebug	Une valeur booléenne qui indique si vous souhaitez que la constante DEBUG soit définie.
DefineTrace	Une valeur booléenne qui indique si vous souhaitez que la constante TRACE soit définie.
DebugType	Définit le niveau d'informations de débogage que vous souhaitez générer.Les valeurs valides sont "full", "pdbonly" et "none".
DelaySign	Une valeur booléenne qui indique si vous souhaitez différer la signature de l'assembly plutôt que de le signer complètement.
DisabledWarnings	Supprime les avertissements spécifiés.Seule la partie numérique de l'identificateur d'avertissement doit être spécifiée.Les différents avertissements sont séparés par des points-virgules.Ce paramètre correspond au commutateur /nowarn du compilateur vbc.exe.
DisableFastUpToDateCheck	Une valeur booléenne qui s'applique uniquement à Visual Studio.Le gestionnaire de génération Visual Studio utilise un processus appelé FastUpToDateCheck pour déterminer si un projet doit être régénéré pour être à jour.Il est plus rapide d'utiliser ce processus que MSBuild.Affecter à la propriété DisableFastUpToDateCheck la valeur true vous permet d'ignorer le gestionnaire de génération Visual Studio et de le forcer à utiliser MSBuild pour déterminer si le projet est à jour.
DocumentationFile	Le nom du fichier généré en tant que fichier de documentation XML.Ce nom comporte uniquement le nom du fichier et pas le chemin d'accès.
ErrorReport	Indique comment la tâche du compilateur doit signaler les erreurs internes du compilateur.Les valeurs valides sont "prompt", "send" ou "none". Cette propriété est équivalente au commutateur de compilation /errorreport.
ExcludeDeploymentUrl	GenerateDeploymentManifest, tâche ajoute une balise de deploymentProvider au manifeste de déploiement si le fichier projet inclut chacun des éléments : UpdateUrl InstallUrl PublishUrl Utilisation ExcludeDeploymentUrl, toutefois, vous pouvez empêcher la balise de deploymentProvider d'être ajouté au manifeste de déploiement même si l'un des au-dessus de les URL est spécifié. Pour cela, ajoutez la propriété suivante à votre fichier projet : <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl> Remarque ExcludeDeploymentUrl n'est pas exposé dans Visual Studio l'IDE et peut être défini 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 de deploymentProvider sera toujours ajoutée à l'URL spécifiée par PublishUrl.
FileAlignment	Spécifie, en octets, où les sections du fichier de sortie doivent être alignées.Les valeurs autorisées sont 512, 1024, 2048, 4096, 8192.Cette propriété est équivalente au commutateur de compilation /filealignment.
FrameworkPathOverride	Spécifie l'emplacement de mscorlib.dll et de microsoft.visualbasic.dll.Ce paramètre est équivalent au commutateur /sdkpath du compilateur vbc.exe.
GenerateDocumentation	Un paramètre booléen qui indique si la documentation est générée lors de la génération.Si sa valeur est true, les informations de documentation sont générées et placées dans un fichier XML avec le nom de la bibliothèque ou du fichier exécutable créé par la tâche de génération.
IntermediateOutputPath	Le chemin de sortie intermédiaire complet dérivé de BaseIntermediateOutputPath, si aucun chemin d'accès n'est spécifié.Par exemple, \obj\debug\.Si cette propriété est substituée, BaseIntermediateOutputPath n'a alors aucun effet.
KeyContainerName	Nom du conteneur de clé de nom fort.
KeyOriginatorFile	Le nom du fichier de clé de nom fort.
NoWin32Manifest	Détermine si le compilateur génère le manifeste Win32 par défaut dans l'assembly de sortie.La valeur par défaut false signifie que le manifeste Win32 par défaut est généré pour toutes les applications.Cette propriété est équivalente au commutateur /nowin32manifest du compilateur vbc.exe.
ModuleAssemblyName	Le nom de l'assembly dans lequel le module compilé sera incorporé.Cette propriété est équivalente au commutateur de compilation /moduleassemblyname.
NoLogo	Une valeur booléenne qui indique si vous souhaitez que le logo du compilateur soit désactivé.Cette propriété est équivalente au commutateur de compilation /nologo.
NoStdLib	Une 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	Une valeur booléenne qui indique si le runtime Visual Basic (Microsoft.VisualBasic.dll) doit être inclus comme référence dans le projet.
NoWin32Manifest	Valeur booléenne indiquant si les informations de manifeste de contrôle de compte d'utilisateur (UAC, User Account Control) sont incorporées dans l'exécutable de l'application.S'applique uniquement aux projets Visual Studio ciblant Windows Vista.Dans les projets de déploiement à l'aide de ClickOnce et COM sans inscription, cet élément est ignoré. False (valeur par défaut) spécifie que les informations de manifeste de (UAC) de contrôle de compte d'utilisateur sont incorporées dans le fichier exécutable de l'application.True spécifie que les informations de manifeste contrôle de compte d'utilisateur 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 COM sans inscription, cette propriété est ignorée. Vous ne devez ajouter NoWin32Manifest que si vous ne voulez pas que Visual Studio incorpore la moindre information de manifeste dans l'exécutable de l'application ; ce processus s'appelle 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'il existe un nœud <ApplicationManifest>.) Pour les projets Visual C#, attribuez à <ApplicationManifest> la valeur False et à <NoWin32Manifest> la valeur True.(Dans les projets Visual C#, <ApplicationManifest> remplace <NoWin32Manifest>.)
Optimize	Une valeur booléenne qui, si elle possède la valeur true, active les optimisations du compilateur.Cette propriété est équivalente au commutateur de compilation /optimize.
OptionCompare	Spécifie la façon dont sont effectuées les comparaisons de chaînes.Les valeurs valides sont "binary" ou "text". Cette propriété est équivalente au commutateur /optioncompare du compilateur vbc.exe.
OptionExplicit	Une valeur booléenne qui, si elle possède la valeur true, requiert une déclaration explicite des variables dans le code source.Cette propriété est équivalente au commutateur de compilation /optionexplicit.
OptionInfer	Une valeur booléenne qui, si possède la valeur true, active l'inférence de type des variables.Cette propriété est équivalente au commutateur de compilation /optioninfer.
OptionStrict	Une valeur booléenne qui, si possède la valeur true, pousse la tâche de génération à appliquer une sémantique de types stricte pour restreindre les conversions de types implicites.Cette propriété est équivalente au commutateur /optionstrict du compilateur vbc.exe.
OutputPath	Spécifie le chemin d'accès au répertoire de sortie, relatif au répertoire de projet, par exemple, « bin\Debug ».
OutputType	Spécifie le format du fichier de sortie.Ce paramètre peut prendre l'une des valeurs suivantes : Library.Crée une bibliothèque de code (.dll).(Valeur par défaut.) Exe.Crée une application console. Module.Crée un module. Winexe.Crée un programme Windows. Cette propriété est équivalente au commutateur /target du compilateur vbc.exe.
OverwriteReadOnlyFiles	Une valeur booléenne qui indique si vous souhaitez permettre à la génération de remplacer les fichiers en lecture seule ou de générer une erreur.
PdbFile	Le nom de fichier du fichier .pdb que vous émettez.Cette propriété est équivalente au commutateur /pdb du compilateur csc.exe.
Plateforme	Le système d'exploitation pour lequel vous générez la cible.Les valeurs valides sont "AnyCPU", "x86", "x64" ou "Itanium".
RemoveIntegerChecks	Une valeur booléenne indiquant s'il convient de désactiver les contrôles d'erreurs de dépassement sur les entiers.La valeur par défaut est false.Cette propriété est équivalente au commutateur /removeintchecks du compilateur vbc.exe.
SGenUseProxyTypes	Une valeur booléenne qui indique si les types de proxy doivent être générés par SGen.exe. La cible SGen utilise cette propriété pour définir l'indicateur UseProxyTypes.Cette propriété a true comme valeur par défaut, et il n'y a aucune interface utilisateur pour modifier ceci.Pour générer l'assembly de sérialisation pour les types non-webservice, ajoutez cette propriété au fichier projet et affectez-lui la valeur false avant d'importer le Microsoft.Common.Targets ou C#/VB.targets.
SGenToolPath	Un chemin d'accès vers un outil facultatif qui indique où obtenir SGen.exe lorsque la version actuelle de SGen.exe est substituée.
StartupObject	Spécifie la classe ou le module qui contient la méthode Main ou la procédure Sub Main.Cette propriété est équivalente au commutateur de compilation /main.
ProcessorArchitecture	L'architecture de processeur utilisée lorsque les références d'assembly sont résolues.Les valeurs valides sont "msil", "x86", "amd64" ou "ia64".
RootNamespace	L'espace de noms racine à utiliser lorsque vous nommez une ressource incorporée.Cet espace de noms fait partie du nom du manifeste de la ressource incorporée.
Satellite_AlgorithmId	L'ID de l'algorithme de hachage AL.exe à utiliser lorsque les assemblys satellites sont créés.
Satellite_BaseAddress	L'adresse de base à utiliser lorsque les assemblys satellites spécifiques à la culture sont générés en utilisant la cible CreateSatelliteAssemblies.
Satellite_CompanyName	Le nom de la société à passer à AL.exe pendant la génération d'assembly satellite.
Satellite_Configuration	Le nom de la configuration à passer à AL.exe pendant la génération d'assembly satellite.
Satellite_Description	Le texte descriptif à passer à AL.exe pendant la génération d'assembly satellite.
Satellite_EvidenceFile	Incorpore le fichier spécifié dans l'assembly satellite qui possède le nom de ressource "Security.Evidence".
Satellite_FileVersion	Spécifie une chaîne pour le champ Version de fichier de l'assembly satellite.
Satellite_Flags	Spécifie une valeur pour le champ Indicateurs de l'assembly satellite.
Satellite_GenerateFullPaths	Force la tâche de génération à utiliser des chemins d'accès absolus pour tous les fichiers signalés dans un message d'erreur.
Satellite_LinkResource	Lie les fichiers de ressources spécifiés à un assembly satellite.
Satellite_MainEntryPoint	Spécifie le nom qualifié complet (autrement dit, 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	Spécifie une chaîne pour le champ Produit de l'assembly satellite.
Satellite_ProductVersion	Spécifie une chaîne pour le champ ProductVersion de l'assembly satellite.
Satellite_TargetType	Spécifie le format de fichier du fichier de sortie de l'assembly satellite : "library", "exe" ou "win". La valeur par défaut est "library".
Satellite_Title	Spécifie une chaîne pour le champ Titre de l'assembly satellite.
Satellite_Trademark	Spécifie une chaîne pour le champ Marque déposée de l'assembly satellite.
Satellite_Version	Spécifie les informations de version concernant l'assembly satellite.
Satellite_Win32Icon	Insère un fichier icône .ico dans l'assembly satellite.
Satellite_Win32Resource	Insère une ressource Win32 (fichier .res) dans l'assembly satellite.
SubsystemVersion	Spécifie la version minimale du sous-système que le fichier exécutable généré peut utiliser.Cette propriété est équivalente au commutateur de compilation /subsystemversion.Pour plus d'informations sur la valeur par défaut de cette propriété, consultez /subsystemversion (Visual Basic) ou le /subsystemversion (Options du compilateur C#).
TargetCompactFramework	La version du .NET Compact Framework requise pour exécuter l'application que vous générez.Préciser ceci vous permet de référencer certains assemblys que vous n'auriez pu référencer autrement.
TargetFrameworkVersion	La version de .NET Framework requise pour exécuter l'application que vous générez.Préciser ceci vous permet de référencer certains assemblys que vous n'auriez pu référencer autrement.
TreatWarningsAsErrors	Un paramètre booléen qui, s'il est défini à true, cause le traitement de tous les avertissements en tant qu'erreurs.Ce paramètre est équivalent au commutateur de compilation /nowarn.
UseHostCompilerIfAvailable	Un paramètre booléen qui, s'il est défini à true, force la tâche de génération à utiliser l'objet de compilateur in-process, s'il est disponible.Ce paramètre est utilisé uniquement par Visual Studio.
Utf8Output	Un paramètre booléen qui, s'il est défini à true, enregistre la sortie de compilateur en utilisant l'encodage UTF-8.Ce paramètre est équivalent au commutateur de compilation /utf8Output.
VbcToolPath	Un chemin d'accès facultatif qui indique un autre emplacement de vbc.exe lorsque la version actuelle de vbc.exe est substituée.
VbcVerbosity	Spécifie le niveau de commentaires de la sortie du compilateur Visual Basic.Les valeurs valides sont "Quiet", "Normal" (valeur par défaut) ou "Verbose".
VisualStudioVersion	Spécifie la version de Visual Studio dans laquelle ce projet doit être considéré exécuter.Si cette propriété n'est pas spécifiée, MSBuild la place une valeur par défaut sens. Cette propriété est utilisée dans plusieurs types de projet pour spécifier l'ensemble des cibles qui sont utilisées pour la génération.Si ToolsVersion a la valeur 4,0 ou supérieur d'un projet, VisualStudioVersion est utilisé pour spécifier un qui Sub- ensemble d'outils à utiliser.Pour plus d'informations, consultez Ensemble d'outils MSBuild (ToolsVersion).
WarningsAsErrors	Spécifie une liste d'avertissements à traiter comme des erreurs.Ce paramètre est équivalent au commutateur de compilation /warnaserror.
WarningsNotAsErrors	Spécifie une liste d'avertissements à ne pas traiter comme des erreurs.Ce paramètre est équivalent au commutateur de compilation /warnaserror.
Win32Manifest	Le nom du fichier manifeste qui doit être incorporé dans l'assembly final.Ce paramètre est équivalent au commutateur de compilation /win32Manifest.
Wint32Resource	Le nom de fichier de la ressource Win32 à incorporer dans l'assembly final.Ce paramètre est équivalent au commutateur de compilation /win32resource.

Voir aussi

Référence

Éléments communs des projets MSBuild