Compiler.Compile(String[], String[], String, String[], IDictionary) Methode

  • Referenz

Definition

Namespace:
Microsoft.CSharp
Assembly:
cscompmgd.dll

Kompiliert die angegebenen C#-Quellen zur angegebenen Datei.

public:
 static cli::array <Microsoft::CSharp::CompilerError ^> ^ Compile(cli::array <System::String ^> ^ sourceTexts, cli::array <System::String ^> ^ sourceTextNames, System::String ^ target, cli::array <System::String ^> ^ imports, System::Collections::IDictionary ^ options);
public static Microsoft.CSharp.CompilerError[] Compile (string[] sourceTexts, string[] sourceTextNames, string target, string[] imports, System.Collections.IDictionary options);
static member Compile : string[] * string[] * string * string[] * System.Collections.IDictionary -> Microsoft.CSharp.CompilerError[]
Public Shared Function Compile (sourceTexts As String(), sourceTextNames As String(), target As String, imports As String(), options As IDictionary) As CompilerError()

Parameter

sourceTexts
String[]

Ein Array vom Typ Zeichenfolge, jedes mit C#-Code.

sourceTextNames
String[]

Ein Array der Typzeichenfolge, die die Dateinamen für alle sourceTexts-Parameter enthält.

target
String

Der Name der Ausgabedatei. Dieses Argument ist erforderlich.

imports
String[]

Ein Array der Typzeichenfolge, das Dateien enthält, auf die verwiesen werden kann.

options
IDictionary

Ein IDictionary mit Compileroptionen.

Gibt zurück

CompilerError[]

Gibt Diagnosemeldungen als Array vom Typ CompilerError zurück. Wenn dass Array leer ist oder ausschließlich Warnungselemente zurückgegeben werden, war die Kompilierung erfolgreich.

Ausnahmen

ArgumentNullException

sourceTexts ist null.

- oder -

sourceTextNames ist null.

- oder -

target ist null.

ArgumentOutOfRangeException

sourceTexts ist ein leeres Array.

- oder -

sourceTextNames und sourceTexts haben nicht die gleiche Größe.

Hinweise

Jede Zeichenfolge im sourceTexts Parameter entspricht einer einzelnen Quelldatei. Es muss mindestens ein sourceTexts Element vorhanden sein.

Die Dateinamen im sourceTextNames Parameter werden für Compiler- Diagnose- und Debuginformationen verwendet. Das Array ist erforderlich, kann aber mithilfe der #line -Anweisung lokal überschrieben werden. Das Array muss die gleiche Anzahl von Elementen wie der sourceTexts Parameter aufweisen.

Der imports Parameter ist identisch mit der /reference Compileroption. Dieser Parameter kann null sein.

Für den options -Parameter ist der Schlüssel die Kurzform der Compileroption. Der Wert ist der gewünschte Wert für die Option. Der options Parameter kann sein null. Für einige Compileroptionen werden nicht erkannt. Die folgende Tabelle zeigt die erkannten Optionen und Werte.

Schlüsselname Verbrauch
addmodule Liste der Module in dieser Assembly eingeschlossen werden sollen. Die Modulnamen müssen durch den senkrechten Strich oder einen senkrechten Strich getrennt werden. Der Wert muss vom Typ String sein. Finden Sie unter - Addmodule (C# -Compileroptionen).
baseaddress Die Basisadresse für Bibliotheken. Der Wert muss vom Typ UInt32 sein. Finden Sie unter - Baseaddress (C# -Compileroptionen).
bugreport Erzeugt die Fehlerprotokolldatei. Der Wert muss vom Typ String sein. Finden Sie unter - Bugreport (C# -Compileroptionen).
checked Legen Sie die Standard-ausdrucksauswertung checked (oder nicht). Der Wert muss vom Typ Boolean sein. Finden Sie unter -überprüft (C# -Compileroptionen).
d Liste der durch Semikolon getrennte Symbole zu definieren. Der Wert muss vom Typ String sein. Finden Sie unter -definieren (C# -Compileroptionen).
debug Ausgeben von Debuginformationen mit Ausgabe. Der Wert muss vom Typ Boolean sein. Vollständig oder nur PDB-Datei kann nicht angegeben werden. Finden Sie unter -Debuggen (C# -Compileroptionen).
doc Der Dateiname für XML-Kommentare. Der Wert muss vom Typ String sein. Finden Sie unter -Doc (C# -Compileroptionen).
filealign Ausrichtung Abschnittsgröße PE. Der Wert muss vom Typ UInt32 sein. Finden Sie unter - Filealign (C# -Compileroptionen).
incr Aktivieren Sie inkrementelle erneute Erstellung. Der Wert muss vom Typ Boolean sein.
lib Zusätzliche zu durchsuchende Pfade beim Suchen von Modulen und Assemblys verwiesen wird. Der Wert muss vom Typ String sein. Finden Sie unter -Lib (C# -Compileroptionen).
linkres Verknüpfen Sie eine verwaltete Ressource, auf die Assembly. Der Wert muss vom Typ String sein. Finden Sie unter - Linkresource (C# -Compileroptionen).
m Typ, der für die Main-Methode in gesucht werden soll. Der Wert muss vom Typ String sein. Finden Sie unter -main (C# -Compileroptionen).
nostdlib Führen Sie keine automatischen Verweise auf "mscorlib.dll". Der Wert muss vom Typ Boolean sein. Finden Sie unter - Nostdlib (C# -Compileroptionen).
nowarn Liste der durch Semikolon getrennte Warnzahlen, die nicht Bericht. Der Wert muss vom Typ String sein. Finden Sie unter - Nowarn (C# -Compileroptionen).
o Compileroptimierungen zu aktivieren. Der Wert muss vom Typ Boolean sein. Finden Sie unter -optimieren (C# -Compileroptionen).
r Assemblys, auf die verwiesen wird. Wert muss vom Typ "String" sein. Wenn mehr als eine Assembly angegeben wird, muss der Dateiname durch den senkrechten Strich oder einen senkrechten Strich getrennt werden. Finden Sie unter -Verweis (C# -Compileroptionen).
res Verwaltete Ressource einbetten. Der Wert muss vom Typ String sein. Finden Sie unter -Ressource (C# -Compileroptionen).
target Dateizieltyp eine der folgenden ausgegeben: "Library", "Exe", "Winexe" oder "Modul". Der Wert muss vom Typ String sein. Finden Sie unter -Ziel (C# -Compileroptionen).
unsafe Ermöglichen Sie unsicheren Konstrukte. Der Wert muss vom Typ Boolean sein. Finden Sie unter -unsafe (C# -Compileroptionen).
w Warnstufe (0-4). Der Wert muss vom Typ String sein. Finden Sie unter -Warnung (C# -Compileroptionen).
warnaserror Warndiagnosen als Fehler zu melden. Der Wert muss vom Typ Boolean sein. Finden Sie unter - Warnaserror (C# -Compileroptionen).
win32icon Win32-Symbol für "Auto" generiert die Win32-Ressource. Der Wert muss vom Typ String sein. Finden Sie unter -win32icon (C# -Compileroptionen).
win32res Win32-Ressourcendatei. Der Wert muss vom Typ String sein. Finden Sie unter -win32res (C# -Compileroptionen).

Gilt für:

Weitere Informationen