Partager via


CL (tâche)

Remarque

Cette tâche est disponible uniquement lors de l’utilisation du système de génération C++.

Wrappe l’outil de compilateur Microsoft C++, cl.exe. Le compilateur produit des fichiers exécutables (.exe), des fichiers de bibliothèque de liens dynamiques (.dll) ou des fichiers de module de code (.netmodule). Pour plus d’informations, consultez Options de compilateur, et Utiliser MSBuild à partir de la ligne de commande et Utiliser l’ensemble d’outils Microsoft C++ à partir de la ligne de commande.

Paramètres

La liste ci-dessous décrit les paramètres de la tâche CL. La plupart des paramètres de tâche, et quelques ensembles de paramètres, correspondent à une option de ligne de commande.

  • AdditionalIncludeDirectories

    Paramètre String[] facultatif.

    Ajoute un répertoire à la liste des répertoires dans lesquels sont recherchés les fichiers include.

    Pour plus d’informations, consultez /I (Autres répertoires Include).

  • AdditionalOptions

    Paramètre de chaîne facultatif.

    Liste des options de ligne de commande. Par exemple, « /<option1> /<option2> /<option#> ». Utilisez ce paramètre pour spécifier des options de ligne de commande qui ne sont pas représentées par un autre paramètre de tâche.

    Pour plus d’informations, consultez Options du compilateur.

  • AdditionalUsingDirectories

    Paramètre String[] facultatif.

    Spécifie un répertoire dans lequel le compilateur doit faire une recherche en vue de résoudre les références de fichiers transmises à la directive #using.

    Pour plus d’informations, consultez /AI (Spécifier les répertoires des métadonnées).

  • AlwaysAppend

    Paramètre de chaîne facultatif.

    Chaîne qui toujours est émise sur la ligne de commande. Sa valeur par défaut est « /c ».

  • AssemblerListingLocation

    Crée un fichier listing qui contient le code de l’assembly.

    Pour plus d’informations, consultez l’option /Fa dans /FA, /Fa (Fichier listing).

  • AssemblerOutput

    Paramètre de chaîne facultatif.

    Crée un fichier listing qui contient le code de l’assembly.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.

    • NoListing - <none>

    • AssemblyCode - /FA

    • AssemblyAndMachineCode - /FAc

    • AssemblyAndSourceCode - /FAs

    • All - /FAcs

      Pour plus d’informations, consultez les options /FA, /FAc, /FAs et /FAcs dans /FA, /Fa (Fichier listing).

  • BasicRuntimeChecks

    Paramètre de chaîne facultatif.

    Active et désactive la fonctionnalité de vérification des erreurs d’exécution, conjointement avec le pragma runtime_checks.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.

  • BrowseInformation

    Paramètre booléen facultatif.

    Si true, crée un fichier d’informations de consultation.

    Pour plus d’informations, consultez l’option /FR dans /FR, /Fr (Créer un fichier .sbr).

  • BrowseInformationFile

    Paramètre de chaîne facultatif.

    Spécifie un nom pour le fichier d’informations de consultation.

    Pour plus d’informations, consultez le paramètre BrowseInformation dans ce tableau ainsi que /FR, /Fr (Créer un fichier .sbr).

  • BufferSecurityCheck

    Paramètre booléen facultatif.

    Si true, détecte des dépassements de mémoire tampon qui remplacent l’adresse de retour, une technique courante pour exploiter le code qui n’applique pas les restrictions de taille de la mémoire tampon.

    Pour plus d’informations, consultez /GS (Vérification de la sécurité des mémoires tampons).

  • BuildingInIDE

    Paramètre booléen facultatif.

    Si true, indique que MSBuild est appelé par l’IDE. Dans le cas contraire, MSBuild est appelé sur la ligne de commande.

  • CallingConvention

    Paramètre de chaîne facultatif.

    Spécifie la convention d’appel qui détermine l’ordre dans lequel les arguments de fonction sont poussés sur la pile, si la fonction de l’appelant ou la fonction appelée supprime les arguments de la pile à la fin de l’appel, ainsi que la convention de décoration de nom que le compilateur utilise pour identifier des fonctions individuelles.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.

  • CompileAs

    Paramètre de chaîne facultatif.

    Spécifie s’il convient de compiler le fichier d’entrée en tant que fichier source C ou C++.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.

  • CompileAsManaged

    Paramètre de chaîne facultatif.

    Permet aux applications et aux composants d’utiliser les fonctionnalités du Common Language Runtime (CLR).

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.

  • CreateHotpatchableImage

    Paramètre booléen facultatif.

    Si true, indique au compilateur de préparer une image pour la création d’images corrigeables en mémoire. Ce paramètre vérifie que la première instruction de chaque fonction utilise deux octets, comme cela est requis pour la création d’images corrigeables en mémoire.

    Pour plus d’informations, consultez /hotpatch (Créer une image corrigeable en mémoire).

  • DebugInformationFormat

    Paramètre de chaîne facultatif.

    Sélectionne le type d’informations de débogage créées pour votre programme et spécifie si ces informations doivent être conservées dans des fichiers objets (.obj) ou dans une base de données de programme (PDB).

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.

  • DisableLanguageExtensions

    Paramètre booléen facultatif.

    Si true, indique au compilateur d’émettre une erreur pour les constructions de langage qui ne sont compatibles ni avec ANSI C ni avec ANSI C++.

    Pour plus d’informations, consultez l’option /Za dans /Za, /Ze (Désactiver les extensions de langage).

  • DisableSpecificWarnings

    Paramètre String[] facultatif.

    Désactive les numéros d’avertissement spécifiés dans une liste séparée par des points-virgules.

    Pour plus d’informations, consultez l’option /wd dans /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Niveau d’avertissement).

  • EnableEnhancedInstructionSet

    Paramètre String facultatif.

    Spécifie l’architecture de génération de code qui utilise les instructions SSE (Streaming SIMD Extensions), Streaming SIMD Extensions 2 (SSE2) et Advanced Vector Extensions (AVX).

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.

    • NoExtensions - /arch :IA32

    • StreamingSIMDExtensions - /arch:SSE

    • StreamingSIMDExtensions2 - /arch:SSE2

    • AdvancedVectorExtensions - /arch :AVX

    • AdvancedVectorExtensions2 - /arch :AVX2

    • AdvancedVectorExtensions512 - /arch :AVX512

      Pour plus d’informations, consultez l’article /arch (x86).

  • EnableFiberSafeOptimizations

    Paramètre booléen facultatif.

    Si true, prend en charge la sécurité des fibres pour les données allouées en utilisant un stockage local des threads de type statique, autrement dit les données allouées en utilisant __declspec(thread).

    Pour plus d’informations, consultez /GT (Prendre en charge le stockage local des threads avec fibres sécurisées).

  • EnablePREfast

    Paramètre booléen facultatif.

    Si true, active l’analyse du code.

    Pour plus d’informations, consultez /analyze (Analyse de code).

  • ErrorReporting

    Paramètre de chaîne facultatif.

    Vous permet de signaler les erreurs internes du compilateur (ICE) directement à Microsoft. Par défaut, dans les générations en mode IDE, le paramètre est Prompt tandis que dans les générations en mode ligne de commande, il s’agit du paramètre Queue.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.

  • ExceptionHandling

    Paramètre de chaîne facultatif.

    Spécifie le modèle de gestion des exceptions à utiliser par le compilateur.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.

  • ExpandAttributedSource

    Paramètre booléen facultatif.

    Si true, crée un fichier listing dont les attributs développés sont injectés dans le fichier source.

    Pour plus d’informations, consultez /Fx (Fusionner le code injecté).

  • FavorSizeOrSpeed

    Paramètre de chaîne facultatif.

    Spécifie s’il convient de privilégier la vitesse du code ou sa taille.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.

  • FloatingPointExceptions

    Paramètre booléen facultatif.

    Si true, active le modèle de virgule flottante fiable. Des exceptions sont levées dès leur déclenchement.

    Pour plus d’informations, consultez l’option /fp:except dans /fp (Spécifier le comportement de virgule flottante).

  • FloatingPointModel

    Paramètre de chaîne facultatif.

    Définit le modèle de virgule flottante.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.

  • ForceConformanceInForLoopScope

    Paramètre booléen facultatif.

    Si true, implémente un comportement C++ standard dans les boucles for utilisant les extensions Microsoft (/Ze).

    Pour plus d’informations, consultez /Zc:forScope (Conformité forcée dans la portée d’une boucle For).

  • ForcedIncludeFiles

    Paramètre String[] facultatif.

    Entraîne le traitement d’un ou de plusieurs fichiers d’en-tête spécifiés par le préprocesseur.

    Pour plus d’informations, consultez /FI (Nommer le fichier Include imposé).

  • ForcedUsingFiles

    Paramètre String[] facultatif.

    Entraîne le traitement d’un ou de plusieurs fichiers #using spécifiés par le préprocesseur.

    Pour plus d’informations, consultez /FU (Nommer le fichier #using imposé).

  • FunctionLevelLinking

    Paramètre Boolean facultatif.

    Si true, permet au compilateur d’empaqueter des fonctions individuelles sous la forme de fonctions empaquetées (COMDATs).

    Pour plus d’informations, consultez /Gy (Activer la liaison au niveau des fonctions).

  • GenerateXMLDocumentationFiles

    Paramètre Boolean facultatif.

    Si la valeur est true, le compilateur traite les commentaires de la documentation dans les fichiers de code source, et crée un fichier .xdc pour chaque fichier de code source qui comporte de tels commentaires.

    Pour plus d’informations, consultez /doc (Traiter les commentaires de documentation) (C/C++). Consultez également le paramètre XMLDocumentationFileName dans ce tableau.

  • IgnoreStandardIncludePath

    Paramètre Boolean facultatif.

    Si true, empêche le compilateur de rechercher des fichiers include dans les répertoires spécifiés dans les variables d’environnement PATH et INCLUDE.

    Pour plus d’informations, consultez /X (Ignorer les chemins Include standard).

  • InlineFunctionExpansion

    Paramètre String facultatif.

    Spécifie le niveau d’expansion des fonctions inline pour la génération.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.

  • IntrinsicFunctions

    Paramètre Boolean facultatif.

    Si true, remplace certains appels de fonction par une forme intrinsèque ou par d’autres formes spéciales de la fonction qui contribuent à une exécution plus rapide de votre application.

    Pour plus d’informations, consultez /Oi (Générer des fonctions intrinsèques).

  • MinimalRebuild

    Paramètre Boolean facultatif. Cette fonction est déconseillée.

    Si true, permet une régénération minimale, qui détermine si les fichiers sources C++ qui incluent des définitions de classe C++ modifiées (stockées dans des fichiers d’en-tête [.h]) doivent être recompilés.

    Pour plus d’informations, consultez /Gm (Activer la regénération minimale).

  • MultiProcessorCompilation

    Paramètre Boolean facultatif.

    Si true, utilise plusieurs processeurs pour procéder à la compilation. Ce paramètre crée un processus pour chaque processeur effectif de votre ordinateur.

    Pour plus d’informations, consultez /MP (Générer avec plusieurs processus). Consultez également le paramètre ProcessorNumber dans ce tableau.

  • ObjectFileName

    Paramètre String facultatif.

    Spécifie un nom de fichier objet (.obj) ou un répertoire à utiliser à la place de la valeur par défaut.

    Pour plus d’informations, consultez /Fo (Nom de fichier objet).

  • ObjectFiles

    Paramètre String[] facultatif.

    Liste des fichiers objets.

  • OmitDefaultLibName

    Paramètre Boolean facultatif.

    Si la valeur est true, omet le nom de la bibliothèque runtime C par défaut du fichier objet (.obj). Par défaut, le compilateur place le nom de la bibliothèque dans le fichier .obj afin de diriger l’éditeur de liens vers la bibliothèque appropriée.

    Pour plus d’informations, consultez /Zl (Omettre le nom de la bibliothèque par défaut).

  • OmitFramePointers

    Paramètre Boolean facultatif.

    Si true, empêche la création des pointeurs de frame sur la pile des appels.

    Pour plus d’informations, consultez /Oy (Omission du pointeur frame).

  • OpenMPSupport

    Paramètre Boolean facultatif.

    Si true, le compilateur traite les clauses et directives OpenMP.

    Pour plus d’informations, consultez /openmp (Activer la prise en charge OpenMP 2.0).

  • Optimisation

    Paramètre String facultatif.

    Spécifie différentes optimisations de code en termes de vitesse et de taille.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.

  • PrecompiledHeader

    Paramètre String facultatif.

    Crée ou utilise un fichier d’en-tête précompilé (.pch) pendant la génération.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.

  • PrecompiledHeaderFile

    Paramètre String facultatif.

    Spécifie un nom de fichier d’en-tête précompilé à créer ou utiliser.

    Pour plus d’informations, consultez /Yc (Créer un fichier d’en-tête précompilé) et /Yu (Utiliser un fichier d’en-tête précompilé).

  • PrecompiledHeaderOutputFile

    Paramètre String facultatif.

    Spécifie un nom de chemin d’accès pour un en-tête précompilé au lieu d’utiliser le nom du chemin d’accès par défaut.

    Pour plus d’informations, consultez /Fp (Nommer le fichier .pch).

  • PreprocessKeepComments

    Paramètre Boolean facultatif.

    Si true, conserve les commentaires pendant le prétraitement.

    Pour plus d’informations, consultez /C (Conserver les commentaires pendant le prétraitement).

  • PreprocessorDefinitions

    Paramètre String[] facultatif.

    Définit un symbole de prétraitement pour votre fichier source.

    Pour plus d’informations, consultez /D (Définitions de préprocesseur).

  • PreprocessOutput

    Paramètre ITaskItem[] facultatif.

    Définit un tableau d’éléments de sortie de préprocesseur pouvant être consommés et émis par des tâches.

  • PreprocessOutputPath

    Paramètre String facultatif.

    Spécifie le nom du fichier de sortie dans lequel le paramètre PreprocessToFile écrit la sortie prétraitée.

    Pour plus d’informations, consultez /Fi (Prétraiter le nom du fichier de sortie).

  • PreprocessSuppressLineNumbers

    Paramètre Boolean facultatif.

    Si true, prétraite les fichiers sources C et C++ et copie les fichiers prétraités sur le périphérique de sortie standard.

    Pour plus d’informations, consultez /EP (Prétraiter dans stdout sans directive #line).

  • PreprocessToFile

    Paramètre Boolean facultatif.

    Si true, prétraite les fichiers sources C et C++ et copie la sortie prétraitée dans un fichier.

    Pour plus d’informations, consultez /P (Prétraiter dans un fichier).

  • ProcessorNumber

    Paramètre Integer facultatif.

    Spécifie le nombre maximal de processeurs à utiliser dans une compilation multiprocesseur. Utilisez ce paramètre conjointement avec le paramètre MultiProcessorCompilation.

  • ProgramDataBaseFileName

    Paramètre String facultatif.

    Spécifie un nom pour le fichier de base de données du programme (PDB).

    Pour plus d’informations, consultez /Fd (Nom de fichier PDB).

  • RuntimeLibrary

    Paramètre String facultatif.

    Indique si un module multithread est une DLL et sélectionne les versions retail ou debug de la bibliothèque runtime.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.

  • RuntimeTypeInfo

    Paramètre Boolean facultatif.

    Si true, ajoute le code pour vérifier les types d’objet C++ à l’exécution (informations de type au moment de l’exécution).

    Pour plus d’informations, consultez /GR (Activer les informations de type au moment de l’exécution).

  • ShowIncludes

    Paramètre Boolean facultatif.

    Si true, le compilateur sort la liste des fichiers include.

    Pour plus d’informations, consultez /showIncludes (Liste des fichiers Include).

  • SmallerTypeCheck

    Paramètre Boolean facultatif.

    Si true, signale une erreur d’exécution si une valeur est affectée à un type de données inférieur et provoque une perte de données.

    Pour plus d’informations, consultez l’option /RTCc dans /RTC (Vérifications des erreurs au moment de l’exécution).

  • Sources

    Paramètre ITaskItem[] requis.

    Spécifie la liste des fichiers sources séparés par des espaces.

  • StringPooling

    Paramètre Boolean facultatif.

    Si true, permet au compilateur de créer une copie de chaînes identiques dans l’image du programme.

    Pour plus d’informations, consultez /GF (Supprimer les doublons).

  • StructMemberAlignment

    Paramètre String facultatif.

    Spécifie l’alignement des octets pour tous les membres d’une structure.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.

  • SuppressStartupBanner

    Paramètre Boolean facultatif.

    Si la valeur est true, empêche l'affichage du message de copyright et de numéro de version quand la tâche démarre.

    Pour plus d’informations, consultez /nologo (Supprimer la bannière de démarrage) (C/C++).

  • TrackerLogDirectory

    Paramètre String facultatif.

    Spécifie le répertoire intermédiaire dans lequel sont stockés les fichiers journaux de suivi de cette tâche.

    Pour plus d’informations, consultez les paramètres TLogReadFiles et TLogWriteFiles dans ce tableau.

  • TreatSpecificWarningsAsErrors

    Paramètre String[] facultatif.

    Traite la liste spécifiée des avertissements du compilateur comme des erreurs.

    Pour plus d’informations, consultez l’option /wen dans /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Niveau d’avertissement).

  • TreatWarningAsError

    Paramètre Boolean facultatif.

    Si true, considère tous les avertissements du compilateur comme des erreurs.

    Pour plus d’informations, consultez l’option /WX dans /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Niveau d’avertissement).

  • TreatWChar_tAsBuiltInType

    Paramètre Boolean facultatif.

    Si true, considère le type wchar_t comme un type natif.

    Pour plus d’informations, consultez /Zc:wchar_t (wchar_t est un type natif).

  • UndefineAllPreprocessorDefinitions

    Paramètre Boolean facultatif.

    Si true, annule la définition des symboles propres à Microsoft que le compilateur définit.

    Pour plus d’informations, consultez l’option /u dans /U, /u (Annuler la définition des symboles).

  • UndefinePreprocessorDefinitions

    Paramètre String[] facultatif.

    Indique une liste d’un ou de plusieurs symboles de préprocesseur dont la définition va être annulée.

    Pour plus d’informations, consultez l’option /U dans /U, /u (Annuler la définition des symboles).

  • UseFullPaths

    Paramètre Boolean facultatif.

    Si true, affiche le chemin d’accès complet des fichiers de code source transmis au compilateur dans les diagnostics.

    Pour plus d’informations, consultez /FC (Chemin complet du fichier de code source dans les diagnostics).

  • UseUnicodeForAssemblerListing

    Paramètre Boolean facultatif.

    Si true, entraîne la création du fichier de sortie au format UTF-8.

    Pour plus d’informations, consultez l’option /FAu dans /FA, /Fa (Fichier listing).

  • WarningLevel

    Paramètre String facultatif.

    Spécifie le niveau d’avertissement le plus élevé devant être généré par le compilateur.

    Spécifiez l'une des valeurs suivantes, chacune d'elles correspondant à une option de ligne de commande.

  • WholeProgramOptimization

    Paramètre Boolean facultatif.

    Si true, active l’optimisation de l’ensemble du programme.

    Pour plus d’informations, consultez /GL (Optimisation de l’ensemble du programme).

  • XMLDocumentationFileName

    Paramètre String facultatif.

    Spécifie le nom des fichiers de documentation XML générés. Ce paramètre peut être un nom de fichier ou de répertoire.

    Pour plus d’informations, consultez l’argument name dans /doc (Traiter les commentaires de documentation) (C/C++). Consultez également le paramètre GenerateXMLDocumentationFiles dans ce tableau.

  • MinimalRebuildFromTracking

    Paramètre Boolean facultatif.

    Si true, une génération incrémentielle suivie est exécutée ; si false, une régénération est exécutée.

  • TLogReadFiles

    Paramètre ITaskItem[] facultatif.

    Spécifie un tableau des éléments qui représentent les journaux de suivi des fichiers lus.

    Un journal de suivi des fichiers lus (.tlog) contient les noms des fichiers d’entrée qui sont lus par une tâche. Il est utilisé par le système de conception de projet pour prendre en charge des builds incrémentielles. Pour plus d’informations, consultez les paramètres TrackerLogDirectory et TrackFileAccess dans ce tableau.

  • TLogWriteFiles

    Paramètre ITaskItem[] facultatif.

    Spécifie un tableau des éléments qui représentent les journaux de suivi des fichiers écrits.

    Un journal de suivi des fichiers écrits (.tlog) contient les noms des fichiers d’entrée qui sont écrits par une tâche. Il est utilisé par le système de conception de projet pour prendre en charge des builds incrémentielles. Pour plus d’informations, consultez les paramètres TrackerLogDirectory et TrackFileAccess dans ce tableau.

  • TrackFileAccess

    Paramètre Boolean facultatif.

    Si true, effectue le suivi des modèles d’accès au fichier.

    Pour plus d’informations, consultez les paramètres TLogReadFiles et TLogWriteFiles dans ce tableau.

Voir aussi