Freigeben über

Compileroptionen (F#)

  • Artikel

In diesem Thema werden Compilerbefehlszeilenoptionen für den F#-Compiler fsc.exe beschrieben. Die Kompilierungsumgebung kann auch durch Festlegen der Projekteigenschaften gesteuert werden.

Compileroptionen alphabetisch sortiert

In der folgenden Tabelle werden Compileroptionen alphabetisch aufgeführt. Einige der F#-Compileroptionen ähneln den C#-Compileroptionen. Wenn dies der Fall ist, wird ein Link zum Thema für die C#-Compileroptionen zur Verfügung gestellt.

Compileroptionen

Beschreibung

-a <output-filename>

Generiert eine Bibliothek und gibt ihren Dateinamen an. Diese Option ist die Kurzform von --target:library <filename>.

--baseaddress:<string>

Gibt die Basisadresse der zu erstellenden Bibliothek an.

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /baseaddress (C#-Compileroptionen).

--codepage:<int>

Gibt die zum Lesen von Quelldateien verwendete Codepage an.

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /codepage (C#-Compileroptionen).

--consolecolors

Gibt an, dass Fehler und Warnungen farbkodierten Text in der Konsole verwenden.

--crossoptimize[+|-]

Aktiviert oder deaktiviert modulübergreifende Optimierungen.

--delaysign[+|-]

Signiert das Assembly verzögert nur mit dem öffentlichen Teil des Schlüssels für einen starken Namen.

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /delaysign (C#-Compileroptionen).

--checked[+|-]

Aktiviert oder deaktiviert die Generierung von Überlaufprüfungen.

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /checked (C#-Compileroptionen).

--debug[+|-]

-g[+|-]

--debug:[full|pdbonly]

-g: [full|pdbonly]

Aktiviert oder deaktiviert die Generierung der Debuginformationen, oder gibt den Typ der zu generierenden Debuginformationen an. Der Standardwert ist full. Dieser lässt das Anhängen an ein in Ausführung befindliches Programm zu. Wählen Sie pdbonly aus, um beschränkte Debuginformationen abzurufen, die in einer PDB (Program Database)-Datei gespeichert sind.

Entsprechung der C#-Compileroption mit demselben Namen. Weitere Informationen finden Sie unter

/debug (C#-Compileroptionen).

--define:<string>

-d:<string>

Definiert ein bei der bedingten Kompilierung zu verwendendes Symbol.

--doc:<xmldoc-filename>

Weist den Compiler an, in der angegebenen Datei XML-Dokumentationskommentare zu generieren. Weitere Informationen finden Sie unter XML-Dokumentation (F#).

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /doc (C#-Compileroptionen).

--fullpaths

Weist den Compiler an, vollqualifizierte Pfade zu generieren.

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /fullpaths (C#-Compileroptionen).

--help

-?

Zeigt Verwendungsinformationen an, einschließlich einer kurzen Beschreibung aller Compileroptionen.

--highentropyva[+|-]

Aktivieren oder deaktivieren Sie Address Space Layout Randomization (ASLR) mit hoher Entropie, eine verbesserte Sicherheitsfunktion. Das Betriebssystem legt die Speicherorte im Speicher, in denen Infrastruktur für Anwendungen (wie dem Stapel und den Heap) geladen wird, zufällig fest. Wenn Sie diese Option aktivieren, können die Betriebssysteme diese Zufallszuteilung verwenden, um den vollständigen 64-Bit-Adressbereich auf einem 64-Bit-Computer zu verwenden.

--keycontainer:<string>

Gibt einen Schlüsselcontainer mit starkem Namen an.

--keyfile:<filename>

Gibt den Namen einer Datei mit öffentlichem Schlüssel zum Signieren der generierten Assembly an.

--lib:<folder-name>

-I:<folder-name>

Gibt ein Verzeichnis an, in dem Assemblys gesucht werden sollen, auf die verwiesen wird.

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /lib (C#-Compileroptionen).

--linkresource:<resource-info>

Verknüpft eine angegebene Ressource mit der Assembly. Das Format von resource-info ist filename[,name[,public |private]]

Diese Option zum Verknüpfen einer einzelnen Ressource bietet eine Alternative zum Einbetten einer gesamten Ressourcendatei mit der --resource-Option.

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /linkresource (C#-Compileroptionen).

--mlcompatibility

Ignoriert Warnungen, die bei der Verwendung von Funktionen angezeigt werden, die für Kompatibilität mit anderen ML-Versionen konzipiert sind.

--noframework

Deaktiviert den Standardverweis auf die .NET Framework-Assembly.

--nointerfacedata

Weist den Compiler an, die Ressource wegzulassen, die normalerweise einer Assembly hinzugefügt wird, die F#-spezifische Metadaten enthält.

--nologo

Zeigt beim Starten des Compilers nicht den Bannertext an.

--nooptimizationdata

Weist den Compiler an, nur grundlegende Optimierungsoptionen zum Implementieren von Inlinekonstrukten einzuschließen. Dies verhindert zwar modulübergreifende Inlinekonstrukte, verbessert aber die Binärkompatibilität.

--nowin32manifest

Weist den Compiler an, das Standard-Win32-Manifest auszulassen.

--nowarn:<int-list>

Deaktiviert bestimmte, nach Nummern aufgeführte Warnungen. Trennen Sie die einzelnen Warnungsnummern durch ein Komma. Sie können die Warnungsnummer für eine Warnung aus der Kompilierungsausgabe ermitteln.

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /nowarn (C#-Compileroptionen).

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

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

Aktiviert oder deaktiviert Optimierungen. Einige Optimierungsoptionen können selektiv aktiviert oder deaktiviert werden, indem sie aufgeführt werden. Diese lauten nojitoptimize, nojittracking, nolocaloptimize, nocrossoptimize und notailcalls.

--out:<output-filename>

-o:<output-filename>

Gibt den Namen der kompilierten Assembly oder des kompilierten Moduls an.

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /out (C#-Compileroptionen).

--pdb:<pdb-filename>

Benennt die PDB-(Program Database-)Ausgabedebugdatei. Diese Option wird nur angewendet, wenn --debug ebenfalls aktiviert ist.

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /pdb (C#-Compileroptionen).

--platform:<platform-name>

Gibt an, dass der generierte Code nur auf der angegebenen Plattform (x86, Itanium oder x64) ausgeführt wird, oder, wenn der Plattformname anycpu ausgewählt wird, dass der generierte Code auf jeder Plattform ausgeführt werden kann.

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /platform (C#-Compileroptionen).

--quotations-debug

Gibt an, dass zusätzliche Debuginformationen für Ausdrücke ausgegeben werden, die von F#-Quotation-Literalen und reflektierten Definitionen abgeleitet werden. Die Debuginformationen werden zu den benutzerdefinierten Attributen eines F#-Ausdrucksstrukturknotens hinzugefügt. Weitere Informationen erhalten Sie unter Zitieren von Code (F#) und Expr.CustomAttributes.

--reference:<assembly-filename>

-r <assembly-filename>

Macht Code aus einer F#- oder .NET Framework-Assembly für den Code verfügbar, der kompiliert wird.

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /reference (C#-Compileroptionen).

--resource:<resource-filename>

Bettet eine verwaltete Ressourcendatei in die generierte Assembly ein.

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /resource (C#-Compileroptionen).

--sig:<signature-filename>

Generiert eine Signaturdatei auf Grundlage der generierten Assembly. Weitere Informationen zu Signaturdateien finden Sie unter Signaturen (F#).

--simpleresolution

Gibt an, dass Assemblyverweise mit verzeichnisbasierten Mono-Regeln aufgelöst werden sollen, und nicht mit der MSBuild-Auflösung. Sofern nicht Mono verwendet wird, wird standardmäßig die MSBuild-Auflösung verwendet.

--standalone

Gibt an, dass eine Assembly erstellt wird, die alle ihre Abhängigkeiten enthält, damit sie eigenständig ausgeführt wird, ohne dass Bedarf für zusätzliche Assemblys, wie die F#-Bibliothek, besteht.

--staticlink:<assembly-name>

Verknüpft statistisch die angegebene Assembly und alle DLLs, auf die verwiesen wird und die von dieser Assembly abhängen. Verwenden Sie den Assemblynamen, nicht den DLL-Namen.

--subsystemversion

Gibt die Version des Subsystems des Betriebssystems an, das von der generierten ausführbaren Datei verwendet wird. Verwenden Sie 6.02 für Windows 8, 6.01 für Windows 7 und 6.00 für Windows Vista. Diese Option gilt nur für ausführbare Dateien, nicht für DLLs, und kann nur dann verwendet werden, wenn die Anwendung von bestimmten Sicherheitsfeatures abhängt, die nur in bestimmten Betriebssystemversionen verfügbar sind. Wenn diese Option verwendet wird und ein Benutzer versucht, die Anwendung auf einer niedrigeren Version des Betriebssystems auszuführen, wird eine Fehlermeldung angezeigt.

--tailcalls[+|-]

Aktiviert oder deaktiviert die Verwendung der Tail-IL-Anweisung, die die Wiederverwendung des Stapelrahmens für endrekursive Funktionen verursacht. Diese Option ist standardmäßig aktiviert.

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

Gibt den Typ und Dateinamen des generierten kompilierten Codes an.

  • exe weist auf eine Konsolenanwendung hin.

  • winexe weist auf eine Windows-Anwendung hin, die sich von der Konsolenanwendung dadurch unterscheidet, dass für sie keine standardmäßigen Eingabe-/Ausgabestreams (stdin, stdout und stderr) definiert sind.

  • library ist eine Assembly ohne Einstiegspunkt.

  • module ist ein .NET Framework-Modul (.netmodule), was später mit anderen Modulen zu einer Assembly kombiniert werden kann.

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /target (C#-Compileroptionen).

--times

Zeigt Zeitinformationen für die Kompilierung an.

--utf8output

Aktiviert das Drucken der Compilerausgabe mit UTF-8-Codierung.

--warn:<warning-level>

Legt eine Warnstufe (0 bis 5) fest. Der Standardwert ist 3. Jeder Warnung wird auf Grundlage ihres Schweregrads eine Stufe zugewiesen. Bei Stufe 5 werden mehr Warnungen (jedoch mit geringerem Schweregrad) als bei Stufe 1 angezeigt.

Warnungen der Stufe 5 sind: 21 (rekursive Verwendung zur Laufzeit aktiviert), 22 (let rec in der falschen Reihenfolge), 45 (vollständige Abstraktion) und 52 (tiefe Kopie). Alle anderen Warnungen sind Stufe 2.

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /warn (C#-Compileroptionen).

--warnon:<int-list>

Aktivieren Sie bestimmte Warnungen, die standardmäßig oder durch eine andere Befehlszeilenoption deaktiviert sind. In F# 3.0 ist nur die Warnung 1182 (nicht verwendete Variablen) standardmäßig deaktiviert.

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

Aktiviert oder deaktiviert die Option zum Ausgeben von Warnungen als Fehler. Sie können bestimmte Warnungsnummern angeben, die deaktiviert oder aktiviert werden sollen. Optionen, die später in der Befehlszeile stehen, überschreiben Optionen, die früher in der Befehlszeile stehen. Wenn Sie beispielsweise Warnungen angeben möchten, die nicht als Fehler gemeldet werden sollen, geben Sie --warnaserror+ --warnaserror-:<int-list> an.

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /warnaserror (C#-Compileroptionen).

--win32manifest:manifest-filename

Fügt eine Win32-Manifestdatei zur Kompilierung hinzu. Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /win32manifest (C#-Compileroptionen).

--win32res:resource-filename

Fügt eine Win32-Ressourcendatei zur Kompilierung hinzu.

Diese Compileroption entspricht der C#-Compileroption gleichen Namens. Weitere Informationen finden Sie unter /win32res (C#-Compileroptionen).

Verwandte Themen

Titel

Beschreibung

F# Interactive-Optionen

Beschreibt vom F#-Interpreter fsi.exe unterstützte Befehlszeilenoptionen.

Referenz zur Projekt-Designer-Benutzeroberfläche

Beschreibt die Benutzeroberfläche für Projekte, einschließlich Projekteigenschaftenseiten, die Buildoptionen bereitstellen.