Partager via


Options du compilateur (F#)

Cette rubrique décrit les options de ligne de commande du compilateur F#, fsc.exe. Vous pouvez également contrôler l'environnement de compilation en définissant les propriétés du projet.

Options du compilateur classées par ordre alphabétique

Le tableau suivant répertorie les options du compilateur par ordre alphabétique. Certaines options du compilateur F# sont semblables à celles du compilateur C#. Si tel est le cas, un lien vers la rubrique des options du compilateur C# est fourni.

Option du compilateur

Description

-a <output-filename>

Génère une bibliothèque et spécifie son nom de fichier. Cette option est une forme abrégée de --target:library <filename>.

--baseaddress:<string>

Spécifie l'adresse de base de la bibliothèque à construire.

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /baseaddress (Options du compilateur C#).

--codepage:<int>

Spécifie la page de codes utilisée pour lire des fichiers sources.

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /codepage (Options du compilateur C#).

--consolecolors

Spécifie que les erreurs et les avertissements utilisent le texte codé par couleur sur la console.

--crossoptimize[+|-]

Active ou désactive des optimisations intermodules.

--delaysign[+|-]

Différer la signature de l'assembly en utilisant uniquement la partie publique de la clé de nom fort.

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /delaysign (Options du compilateur C#).

--checked[+|-]

Active ou désactive la génération de contrôles de dépassement de capacité.

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /checked (Options du compilateur C#).

--debug[+|-]

-g[+|-]

--debug:[full|pdbonly]

-g: [full|pdbonly]

Active ou désactive la génération d'informations de débogage, ou spécifie le type d'informations de débogage à générer. La valeur par défaut est full, qui permet l'attachement des informations à un programme en cours d'exécution. Choisissez pdbonly pour obtenir les informations de débogage limitées stockées dans un fichier pdb (base de données du programme).

Équivalent à l'option de compilateur C# du même nom. Pour plus d'informations, consultez

/debug (Options du compilateur C#).

--define:<string>

-d:<string>

Définit un symbole pour une utilisation dans une compilation conditionnelle.

--doc:<xmldoc-filename>

Indique au compilateur de générer des commentaires de documentation XML dans le fichier spécifié. Pour plus d'informations, consultez Documentation XML (F#).

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /doc (Options du compilateur C#).

--fullpaths

Indique au compilateur de générer des chemins d'accès qualifiés complets.

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /fullpaths (Options du compilateur C#).

--help

-?

Affiche les informations d'utilisation, notamment une brève description de toutes les options du compilateur.

--highentropyva[+|-]

Activez ou désactivez la randomisation du format d'espace d'adresse (ASLR) de haute entropie, qui est une fonction de sécurité renforcée. Le système d'exploitation disperse aléatoirement les emplacements en mémoire où l'infrastructure pour les applications (telles que la pile et le tas) est chargée. Si vous activez cette option, les systèmes d'exploitation peuvent utiliser cette randomisation pour utiliser l'espace d'adressage 64 bits complet sur un ordinateur 64 bits.

--keycontainer:<string>

Spécifie un conteneur de clé de nom fort.

--keyfile:<filename>

Spécifie le nom d'un fichier de clé publique pour la signature de l'assembly généré.

--lib:<folder-name>

-I:<folder-name>

Spécifie un répertoire dans lequel rechercher les assemblys référencés.

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /lib (Options du compilateur C#).

--linkresource:<resource-info>

Lie une ressource spécifiée à l'assembly. Le format de resource-info est filename[,name[,public |private]]

La liaison d'une ressource unique avec cette option constitue une alternative à l'incorporation d'un fichier de ressources entier avec l'option --resource.

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /linkresource (Options du compilateur C#).

--mlcompatibility

Ignore les avertissements qui apparaissent lorsque vous utilisez des fonctionnalités conçues pour la compatibilité avec d'autres versions de ML.

--noframework

Désactive la référence par défaut à l'assembly .NET Framework.

--nointerfacedata

Indique au compilateur d'omettre la ressource qu'il ajoute normalement à un assembly comprenant des métadonnées spécifiques à F#.

--nologo

N'affiche pas le texte de bannière lors du lancement du compilateur.

--nooptimizationdata

Indique au compilateur d'inclure uniquement l'optimisation essentielle à l'implémentation de constructions inline. Empêche l'incorporation (inlining) entre modules mais améliore la compatibilité binaire.

--nowin32manifest

Indique au compilateur d'omettre le manifeste Win32 par défaut.

--nowarn:<int-list>

Désactive des avertissements spécifiques répertoriés par nombre. Séparez chaque numéro d'avertissement par une virgule. Vous pouvez découvrir le numéro d'avertissement de chaque avertissement à partir de la sortie de compilation.

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /nowarn (Options du compilateur C#).

--optimize[+|-] [<string-list>]

-O[+|-] [<string-list>]

Active ou désactive les optimisations. Vous pouvez désactiver ou activer sélectivement certaines options d'optimisation en les répertoriant. Ces options sont les suivantes : nojitoptimize, nojittracking, nolocaloptimize, nocrossoptimize et notailcalls.

--out:<output-filename>

-o:<output-filename>

Spécifie le nom de l'assembly ou du module compilé.

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /out (Options du compilateur C#).

--pdb:<pdb-filename>

Nomme le fichier PDB (base de données du programme) de débogage de la sortie. Cette option s'applique seulement lorsque --debug est également activé.

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /pdb (Options du compilateur C#).

--platform:<platform-name>

Spécifie que le code généré s'exécutera uniquement sur la plateforme spécifiée (x86, Itanium ou x64) ou, si le nom de plateforme anycpu est choisi, que le code généré peut s'exécuter sur n'importe quelle plateforme.

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /platform (Options du compilateur C#).

--quotations-debug

Spécifie que des informations de débogage supplémentaires doivent être émises pour les expressions dérivées des littéraux de quotation F# et des définitions réfléchies. Les informations de débogage sont ajoutées aux attributs personnalisés d'un nœud d'arborescence d'expression F#. Consultez Quotations de code (F#) et Expr.CustomAttributes.

--reference:<assembly-filename>

-r <assembly-filename>

Permet de mettre le code d'un assembly F# ou .NET Framework à disposition du code en cours de compilation.

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez reference (Options du compilateur C#).

--resource:<resource-filename>

Incorpore un fichier de ressources managé dans l'assembly généré.

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /resource (Options du compilateur C#).

--sig:<signature-filename>

Génère un fichier de signature basé sur l'assembly généré. Pour plus d'informations sur les fichiers de signature, consultez Signatures (F#).

--simpleresolution

Spécifie que les références d'assembly doivent être résolues à l'aide de règles Mono basées sur des répertoires plutôt qu'à l'aide de la résolution MSBuild. La valeur par défaut consiste à utiliser la résolution MSBuild, sauf lors de l'exécution sous Mono.

--standalone

Spécifie pour produire un assembly qui contient toutes ses dépendances de sorte qu'il s'exécute seul sans nécessiter d'assemblys supplémentaires, comme la bibliothèque F#.

--staticlink:<assembly-name>

Lier statiquement l'assembly donné et toutes les DLL référencées qui dépendent de cet assembly. Utilisez le nom de l'assembly, et non le nom de la DLL.

--subsystemversion

Spécifie la version du sous-système de système d'exploitation que doit utiliser le fichier exécutable généré. Utilisez 6.02 pour Windows 8, 6.01 pour Windows 7, 6.00 pour Windows Vista. Cette option s'applique uniquement aux fichiers exécutables, pas aux DLL, et doit être utilisée si votre application dépend des fonctionnalités de sécurité spécifiques disponibles uniquement sur certaines versions du système d'exploitation. Si cette option est utilisée et qu'un utilisateur tente d'exécuter votre application sur une version inférieure du système d'exploitation, l'opération échouera avec un message d'erreur.

--tailcalls[+|-]

Active ou désactive l'utilisation de l'instruction IL (Intermediate Language) tail, qui entraîne la réutilisation du frame de pile pour les fonctions récursives tail. Cette option est activée par défaut.

--target:[exe | winexe | library | module ] <output-filename>

Spécifie le type et le nom de fichier du code compilé généré.

  • exe signifie une application console.

  • winexe signifie une application Windows, qui diffère de l'application console dans la mesure où aucun flux d'entrée/sortie standard (stdin, stdout et stderr) n'est défini.

  • library est un assembly sans point d'entrée.

  • module est un module .NET Framework (.netmodule), qui peut être combiné ultérieurement avec d'autres modèles dans un assembly.

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /target (Options du compilateur C#).

--times

Affiche des informations de minutage pour la compilation.

--utf8output

Active l'impression de la sortie du compilateur dans l'encodage UTF-8.

--warn:<warning-level>

Définit un niveau d'avertissement (de 0 à 5). Le niveau par défaut est 3. Chaque avertissement se voit attribuer un niveau selon sa gravité. Le niveau 5 génère plus d'avertissements, mais moins graves, que le niveau 1.

Les avertissements de niveau 5 sont : 21 (utilisation récursive vérifiée au moment de l'exécution), 22 (let rec évalué dans le désordre), 45 (abstraction complète) et 52 (copie défensive). Tous les autres avertissements sont de niveau 2.

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /warn (Options du compilateur C#).

--warnon:<int-list>

Activez les avertissements spécifiques qui peuvent être désactivés par défaut ou par une autre option de ligne de commande. En F# 3 0, seul l'avertissement 1182 (variables inutilisées) est désactivé par défaut.

--warnaserror[+|-] [<int-list>]

Active ou désactive l'option de signalement des avertissements comme erreurs. Vous pouvez fournir des numéros d'avertissement spécifiques à désactiver ou activer. Les options ultérieures de la ligne de commande remplacent les options antérieures de la ligne de commande. Par exemple, pour spécifier les avertissements qui ne doivent pas être signalés comme des erreurs, spécifiez --warnaserror+ --warnaserror-:<int-list>.

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /warnaserror (Options du compilateur C#).

--win32manifest:manifest-filename

Ajoute un fichier manifeste Win32 à la compilation. Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /win32manifest (Options du compilateur C#).

--win32res:resource-filename

Ajoute un fichier de ressources Win32 à la compilation.

Cette option de compilateur équivaut à l'option de compilateur C# du même nom. Pour plus d'informations, consultez /win32res (Options du compilateur C#).

Rubriques connexes

Titre

Description

Options F# Interactive

Décrit les options de ligne de commande prises en charge par l'interpréteur F#, fsi.exe.

Référence de l'interface utilisateur du Concepteur de projets

Décrit l'interface utilisateur pour les projets, notamment les pages propriété de projet qui fournissent des options de génération.