Propriétés communes des projets MSBuild

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

Les fichiers projet dans Visual Studio (.csproj, .vbproj, vcxproj et autres) 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 courants

Nom de propriété ou de 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 la mise à disposition par le compilateur de toutes les informations de type à partir des fichiers spécifiés, pour le projet en cours de compilation. Cette propriété est équivalente au commutateur /addModules du compilateur.
ALToolPath	Chemin d'accès du fichier AL.exe. Cette propriété remplace la version actuelle du fichier AL.exe pour permettre l'utilisation d'une autre version.
ApplicationIcon	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 /win32icon du compilateur.
ApplicationManifest	Spécifie le chemin d'accès du fichier utilisé pour générer les informations de manifeste de Contrôle de compte d'utilisateur externe. 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é à la ResolveKeySource, tâche pour générer la clé réelle utilisée pour signer l'assembly.
AssemblySearchPaths	Liste d'emplacements dans lesquels il convient de rechercher au cours de la résolution de l'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 antérieurement ont priorité sur les entrées ultérieures.
AssemblyName	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 /baseaddress du compilateur.
BaseOutputPath	Spécifie le chemin d'accès de base du fichier de sortie. S'il est défini, MSBuild utilise OutputPath = $(BaseOutputPath)\$(Configuration)\. Exemple de syntaxe : <BaseOutputPath>c:\xyz\bin\</BaseOutputPath>
BaseIntermediateOutputPath	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>
BuildInParallel	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	Valeur booléenne qui indique si les références de projet sont générées par MSBuild. Affectez la valeur false si vous générez votre projet dans l'environnement de développement intégré (IDE) Visual Studio, ou true dans le cas contraire.
CleanFile	Nom du fichier qui sera 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 placé 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 de 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 /codepage du compilateur.
CompilerResponseFile	Fichier réponse facultatif qui peut être passé aux tâches du compilateur.
Configuration	Configuration que vous générez, "Debug" ou "Release".
CscToolPath	Chemin d'accès de csc.exe, le compilateur Visual C#.
CustomBeforeMicrosoftCommonTargets	Nom d'un fichier projet ou fichier de cibles qui doit être importé automatiquement avant l'importation des cibles communes.
DebugSymbols	Valeur booléenne qui indique si les symboles sont générés par la procédure. En spécifiant /p:DebugSymbols=false sur la ligne de commande, vous désactivez la génération de fichiers de symboles de la base de données (.pdb) du programme.
DefineConstants	Définit des constantes conditionnelles du compilateur. 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 /define du compilateur.
DefineDebug	Valeur booléenne qui indique si vous souhaitez que la constante DEBUG soit définie.
DefineTrace	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	Valeur booléenne qui indique si vous souhaitez différer la signature de l'assembly plutôt que 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	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	Nom du fichier généré en tant que fichier de documentation XML. Ce nom inclut uniquement le nom du fichier et ne comporte aucune information de 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" et "none". Cette propriété est équivalente au commutateur /errorreport du compilateur.
ExcludeDeploymentUrl	La GenerateDeploymentManifest, tâche ajoute une balise deploymentProvider au manifeste de déploiement si le fichier du projet contient l'un des éléments suivants : UpdateUrl InstallUrl PublishUrl En utilisant ExcludeDeploymentUrl, vous pouvez empêcher que la balise deploymentProvider soit ajoutée au manifeste de déploiement même si une des URL ci-dessus est spécifiée. Pour ce faire, ajoutez la propriété suivante à votre fichier projet : <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl> Notes ExcludeDeploymentUrl n'est pas exposé dans l'IDE de Visual Studio et ne peut être défini qu'en modifiant manuellement le fichier projet. Quand elle est définie, cette propriété n'affecte pas la publication dans Visual Studio ; autrement dit, la balise deploymentProvider est 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 valides sont 512, 1024, 2048, 4096, 8192. Cette propriété est équivalente au commutateur /filealignment du compilateur.
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	Paramètre booléen qui indique si la documentation est générée par la procédure. 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	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 remplacée, la définition de BaseIntermediateOutputPath n'a alors aucun effet.
KeyContainerName	Nom du conteneur de clé de nom fort.
KeyOriginatorFile	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 de vbc.exe.
ModuleAssemblyName	Nom de l'assembly dans lequel le module compilé doit être incorporé. Cette propriété est équivalente au commutateur /moduleassemblyname du compilateur.
NoLogo	Valeur booléenne qui indique si vous souhaitez que le logo du compilateur soit désactivé. Cette propriété est équivalente au commutateur /nologo du compilateur.
NoStdLib	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	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 qui indique si les informations de manifeste de Contrôle de compte d'utilisateur 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 de COM sans inscription, cet élément est ignoré. False (valeur par défaut) indique que les informations de manifeste du Contrôle de compte utilisateur seront incorporées dans l'exécutable de l'application. True spécifie que les informations de manifeste de Contrôle de compte d'utilisateur ne doivent pas être 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 de 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 à <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#, affectez à <ApplicationManifest> la valeur False et à <NoWin32Manifest> la valeur True. (Dans les projets Visual C#, <ApplicationManifest> remplace <NoWin32Manifest>.)
Optimize	Valeur booléenne qui, lorsqu'elle correspond à true, active les optimisations du compilateur. Cette propriété est équivalente au commutateur /optimize du compilateur.
OptionCompare	Spécifie la façon dont sont effectuées les comparaisons de chaînes. Les valeurs valides sont "binary" et "text". Cette propriété est équivalente au commutateur /optioncompare du compilateur de vbc.exe.
OptionExplicit	Valeur booléenne qui, lorsqu'elle correspond à true, requiert une déclaration explicite des variables dans le code source. Cette propriété est équivalente au commutateur /optionexplicit du compilateur.
OptionInfer	Valeur booléenne qui, lorsqu'elle correspond à true, active l'inférence de type des variables. Cette propriété est équivalente au commutateur /optioninfer du compilateur.
OptionStrict	Valeur booléenne qui, lorsqu'elle correspond à true, pousse la tâche de génération à appliquer une sémantique de type 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 de fichier du fichier de sortie. Ce paramètre peut prendre l'une des valeurs suivantes : Library. 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. Cette propriété est équivalente au commutateur /target du compilateur vbc.exe.
OverwriteReadOnlyFiles	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	Nom du fichier .pdb que vous émettez. Cette propriété est équivalente au commutateur /pdb du compilateur csc.exe.
Plateforme	Système d'exploitation pour lequel vous générez la cible. Les valeurs valides sont « Any CPU », « x86 » et « x64 ».
RemoveIntegerChecks	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	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 aucune option d'interface utilisateur ne permet de modifier cela. 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 Microsoft.Common.Targets ou C#/VB.targets.
SGenToolPath	Chemin d'accès outil facultatif qui indique où obtenir SGen.exe lorsque la version actuelle de SGen.exe est remplacé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 /main du compilateur.
ProcessorArchitecture	Architecture de processeur utilisée lorsque les références d'assembly sont résolues. Les valeurs valides sont "msil", "x86", "amd64" et "ia64".
RootNamespace	Espace de noms racine à utiliser lorsque vous nommez une ressource incorporée. Cet espace de noms fait partie du nom du manifeste de ressources incorporées.
Satellite_AlgorithmId	ID de l'algorithme de hachage AL.exe à utiliser lorsque les assemblys satellites sont créés.
Satellite_BaseAddress	Adresse de base à utiliser lorsque les assemblys satellites spécifiques à la culture sont générés en utilisant la cible CreateSatelliteAssemblies.
Satellite_CompanyName	Nom de la société à passer à AL.exe pendant la génération d'assembly satellite.
Satellite_Configuration	Nom de configuration à passer à AL.exe pendant la génération d'assembly satellite.
Satellite_Description	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 utilisable par le fichier exécutable généré. Cette propriété est équivalente au commutateur /subsystemversion du compilateur. 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	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 Framework que vous ne pourriez peut-être pas référencer autrement.
TargetFrameworkVersion	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 Framework que vous ne pourriez peut-être pas référencer autrement.
TreatWarningsAsErrors	Paramètre booléen qui, s'il a pour valeur true, entraîne le traitement de tous les avertissements comme des erreurs. Ce paramètre est équivalent au commutateur /nowarn du compilateur.
UseHostCompilerIfAvailable	Paramètre booléen qui, s'il a pour valeur 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	Paramètre booléen qui, s'il a pour valeur true, consigne la sortie du compilateur en utilisant l'encodage UTF-8. Ce paramètre est équivalent au commutateur /utf8Output du compilateur.
VbcToolPath	Chemin d'accès facultatif qui indique un autre emplacement pour vbc.exe lorsque la version actuelle de vbc.exe est remplacé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) et "Verbose".
VisualStudioVersion	Spécifie la version de Visual Studio dans laquelle ce projet doit être considéré comme s'exécutant. Si cette propriété est omise, MSBuild la définit en tant que valeur par défaut raisonnable. Cette propriété est utilisée dans plusieurs types de projet pour spécifier l'ensemble des cibles utilisées pour la génération. 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 MSBuild (ToolsVersion).
WarningsAsErrors	Spécifie une liste d'avertissements à traiter comme des erreurs. Ce paramètre est équivalent au commutateur /warnaserror du compilateur.
WarningsNotAsErrors	Spécifie une liste d'avertissements à ne pas traiter comme des erreurs. Ce paramètre est équivalent au commutateur /warnaserror du compilateur.
Win32Manifest	Nom du fichier manifeste qui doit être incorporé dans l'assembly final. Ce paramètre est équivalent au commutateur /win32Manifest du compilateur.
Win32Resource	Nom de fichier de la ressource Win32 à incorporer dans l'assembly final. Ce paramètre est équivalent au commutateur /win32resource du compilateur.

Voir aussi

Référence

Éléments communs des projets MSBuild