Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Aktualisiert: November 2007
Schließt CSC.exe ein und erzeugt ausführbare Dateien (EXE-Dateien), Dynamic Link Library-Dateien (DLL-Dateien) sowie Codemodule (NETMODULE-Dateien). Weitere Informationen zu CSC.exe finden Sie unter C#-Compileroptionen.
Parameter
In der folgenden Tabelle werden die Parameter der Csc-Aufgabe beschrieben.
Parameter |
Beschreibung |
|---|---|
AdditionalLibPaths |
Optionaler String[]-Parameter. Gibt zusätzliche Verzeichnisse an, in denen Verweise gesucht werden sollen. Weitere Informationen hierzu finden Sie unter /lib (Speicherorte für Assemblyverweise angeben) (C#-Compileroptionen). |
AddModules |
Optionaler String-Parameter. Gibt ein oder mehrere Module an, die Bestandteil der Assembly sein sollen. Weitere Informationen finden Sie unter /addmodule (Metadaten importieren) (C#-Compileroptionen). |
AllowUnsafeBlocks |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, wird Code kompiliert, in dem das Schlüsselwort unsafe verwendet wird. Weitere Informationen hierzu finden Sie unter /unsafe (Unsicheren Modus aktivieren) (C#-Compileroptionen). |
BaseAddress |
Optionaler String-Parameter. Gibt die bevorzugte Basisadresse zum Laden einer DLL-Datei an. Die Standardbasisadresse für eine DLL wird von der Common Language Runtime von .NET Framework festgelegt. Weitere Informationen hierzu finden Sie unter /baseaddress (Basisadresse von DLL festlegen) (C#-Compileroptionen). |
CheckForOverflowUnderflow |
Optionaler Boolean-Parameter. Gibt an, ob Ganzzahlarithmetik, die außerhalb des Datentypbereichs liegt, zur Laufzeit eine Ausnahme auslöst. Weitere Informationen finden Sie unter /checked (Ganzzahlarithmetik prüfen) (C#-Compileroptionen). |
CodePage |
Optionaler Int32-Parameter. Gibt die für alle Quellcodedateien in der Kompilierung zu verwendende Codepage an. Weitere Informationen hierzu finden Sie unter /codepage (Codepage für Quellcodedateien angeben) (C#-Compileroptionen). |
DebugType |
Optionaler String-Parameter. Gibt den Debugtyp an. DebugType kann auf full oder pdbonly festgelegt werden. Der Standardwert lautet full. Damit wird das Anfügen eines Debuggers an ein laufendes Programm ermöglicht. Durch Angeben von pdbonly wird das Debuggen von Quellcode ermöglicht, wenn das Programm im Debugger gestartet wird. Der Assembler wird jedoch nur angezeigt, wenn das laufende Programm an den Debugger angefügt ist. Dieser Parameter überschreibt den EmitDebugInformation-Parameter. Weitere Informationen hierzu finden Sie unter /debug (Debuginformationen ausgeben) (C#-Compileroptionen). |
DefineConstants |
Optionaler String-Parameter. Definiert Präprozessorsymbole. Weitere Informationen hierzu finden Sie unter /define (Präprozessordefinition) (C#-Compileroptionen). |
DelaySign |
Optionaler Boolean-Parameter. Der Wert true gibt an, dass die Assembly vollständig signiert werden soll. Der Wert false gibt an, dass Sie nur den öffentlichen Schlüssel in die Assembly einfügen möchten. Dieser Parameter hat nur Auswirkungen, wenn er mit dem KeyFile-Parameter oder dem KeyContainer-Parameter verwendet wird. Weitere Informationen hierzu finden Sie unter /delaysign (Verzögertes Signieren der Assembly) (C#-Compileroptionen). |
DisabledWarnings |
Optionaler String-Parameter. Gibt die Liste der Warnungen an, die deaktiviert werden sollen. Weitere Informationen hierzu finden Sie unter /nowarn (Angegebene Warnungen unterdrücken) (C#-Compileroptionen). |
DocumentationFile |
Optionaler String-Parameter. Verarbeitet Dokumentationskommentare zu einer XML-Datei. Weitere Informationen hierzu finden Sie unter /doc (Dokumentationskommentare verarbeiten) (C#-Compileroptionen). |
EmitDebugInformation |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, generiert die Aufgabe Debuginformationen und fügt sie in eine Programmdatenbankdatei (.pdb) ein. Wenn der Wert false lautet, gibt die Aufgabe keine Debuginformationen aus. Der Standardwert ist false. Weitere Informationen hierzu finden Sie unter /debug (Debuginformationen ausgeben) (C#-Compileroptionen). |
ErrorReport |
Optionaler String-Parameter. Stellt eine einfache Methode dar, um einen internen C#-Fehler an Microsoft zu senden. Dieser Parameter kann den Wert prompt, send oder none aufweisen. Wenn der Parameter auf prompt festgelegt ist, wird bei einem internen Compilerfehler eine Eingabeaufforderung angezeigt. Über die Eingabeaufforderung können Sie einen elektronischen Fehlerbericht an Microsoft senden. Wenn für den Parameter der Wert send festgelegt ist, wird automatisch ein Problembericht gesendet. Wenn für den Parameter der Wert none festgelegt ist, wird der Fehler nur in der Textausgabe des Compilers gemeldet. Der Standardwert ist none. Weitere Informationen finden Sie unter /errorreport (Fehlerberichtverhalten festlegen) (C#-Compileroptionen). |
FileAlignment |
Optionaler Int32-Parameter. Gibt die Größe der Abschnitte in der Ausgabedatei an. Weitere Informationen finden Sie unter /filealign (Abschnittsausrichtung festlegen) (C#-Compileroptionen). |
GenerateFullPaths |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, wird der absolute Pfad zur Datei in der Compilerausgabe angegeben. Lautet der Wert false, wird der Name der Datei angegeben. Der Standardwert ist false. Weitere Informationen hierzu finden Sie unter /fullpaths (Angeben des vollqualifizierten Pfads in der Compilerausgabe) (C#-Compileroptionen). |
KeyContainer |
Optionaler String-Parameter. Gibt den Namen des Kryptografieschlüsselcontainers an. Weitere Informationen finden Sie unter /keycontainer (Container mit einem Schlüssel für einen starken Namen angeben) (C#-Compileroptionen). |
KeyFile |
Optionaler String-Parameter. Gibt den Namen der Datei an, die den kryptografischen Schlüssel enthält. Weitere Informationen finden Sie unter /keyfile (Datei für einen Schlüssel für einen starken Namen angeben) (C#-Compileroptionen). |
LangVersion |
Optionaler String-Parameter. Gibt an, welche Version der Sprache verwendet werden soll. Weitere Informationen finden Sie unter /langversion (konforme Syntax) (C#-Compileroptionen). |
LinkResources |
Optionaler ITaskItem[]-Parameter. Erstellt einen Link zu einer .NET Framework-Ressource in der Ausgabedatei. Die Ressourcendatei wird nicht in der Ausgabedatei platziert. An diesen Parameter übergebene Elemente weisen möglicherweise optionale Metadateneinträge mit den Namen LogicalName und Access auf. LogicalName entspricht dem identifier-Parameter des /linkresource-Schalters und Access dem accessibility-modifier-Parameter. Weitere Informationen hierzu finden Sie unter /linkresource (Mit .NET Framework-Ressource verknüpfen) (C#-Compileroptionen). |
MainEntryPoint |
Optionaler String-Parameter. Gibt den Speicherort der Main-Methode an. Weitere Informationen hierzu finden Sie unter /main (Speicherort der Main-Methode angeben) (C#-Compileroptionen). |
NoConfig |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, wird der Compiler angewiesen, nicht mit der Datei csc.rsp zu kompilieren. Weitere Informationen finden Sie unter /noconfig ("csc.rsp" ignorieren) (C#-Compileroptionen). |
NoLogo |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, wird die Anzeige der Compilerbannerinformationen unterdrückt. Weitere Informationen hierzu finden Sie unter /nologo (Bannerinformationen unterdrücken) (C#-Compileroptionen). |
NoStandardLib |
Optionaler Boolean-Parameter. Der Wert true verhindert den Import der Datei mscorlib.dll, in der der gesamte System-Namespace definiert wird. Verwenden Sie diesen Parameter, wenn Sie einen eigenen System-Namespace sowie eigene Objekte definieren oder erstellen möchten. Weitere Informationen finden Sie unter /nostdlib (Standardbibliothek nicht importieren) (C#-Compileroptionen). |
Optimize |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, werden Optimierungen aktiviert. Durch den Wert false werden Optimierungen deaktiviert. Weitere Informationen hierzu finden Sie unter /optimize (Optimierungen aktivieren/deaktivieren) (C#-Compileroptionen). |
OutputAssembly |
Optionaler String-Ausgabeparameter. Gibt den Namen der Ausgabedatei an. Weitere Informationen hierzu finden Sie unter /out (Ausgabedateinamen festlegen) (C#-Compileroptionen). |
Platform |
Optionaler String-Parameter. Gibt die von der Ausgabedatei verwendete Prozessorplattform an. Dieser Parameter kann den Wert x86, x64 oder anycpu aufweisen. Der Standardwert ist anycpu. Weitere Informationen finden Sie unter /platform (Ausgabeplattform festlegen) (C#-Compileroptionen). |
References |
Optionaler ITaskItem[]-Parameter. Bewirkt, dass die Aufgabe öffentliche Typinformationen von den angegebenen Elementen ins aktuelle Projekt importiert. Weitere Informationen hierzu finden Sie unter /reference (Metadaten importieren) (C#-Compileroptionen). Sie können einen Visual C#-Verweisalias in einer MSBuild-Datei angeben, indem Sie dem ursprünglichen Element "Verweis" die Metadaten Aliases hinzufügen. Um beispielsweise den Alias "LS1" in der folgenden CSC-Befehlszeile festzulegen:
würden Sie Folgendes verwenden: |
Resources |
Optionaler ITaskItem[]-Parameter. Bettet eine .NET Framework-Ressource in die Ausgabedatei ein. An diesen Parameter übergebene Elemente weisen möglicherweise optionale Metadateneinträge mit den Namen LogicalName und Access auf. LogicalName entspricht dem identifier-Parameter des /resource-Schalters und Access dem accessibility-modifier-Parameter. Weitere Informationen hierzu finden Sie unter /resource (Ressourcendatei in Ausgabe einbetten) (C#-Compileroptionen). |
ResponseFiles |
Optionaler String-Parameter. Gibt die Antwortdatei an, die Befehle für diese Aufgabe enthält. Weitere Informationen hierzu finden Sie unter @ (Antwortdatei festlegen) (C#-Compileroptionen). |
Sources |
Optionaler ITaskItem[]-Parameter. Gibt eine oder mehrere Visual C#-Quelldateien an. |
TargetType |
Optionaler String-Parameter. Gibt das Dateiformat der Ausgabedatei an. Dieser Parameter kann den Wert library aufweisen, durch den eine Codebibliothek erstellt wird, den Wert exe, durch den eine Konsolenanwendung erstellt wird, den Wert module, durch den ein Modul erstellt wird, oder den Wert winexe, durch den ein Windows-Programm erstellt wird. Der Standardwert ist library. Weitere Informationen hierzu finden Sie unter /target (Ausgabedateiformat festlegen) (C#-Compileroptionen). |
Timeout |
Optionaler Int32-Parameter. Gibt die Zeit in Millisekunden an, nach der die ausführbare Datei der Aufgabe beendet wird. Der Standardwert lautet Int.MaxValue. Dieser gibt an, dass kein Timeoutintervall festgelegt ist. |
ToolPath |
Optionaler String-Parameter. Gibt den Speicherort an, von dem die Aufgabe die zugrunde liegende ausführbare Datei (CSC.exe) lädt. Wird dieser Parameter nicht angegeben, verwendet die Aufgabe den SDK-Installationspfad für die Framework-Version, in der MSBuild ausgeführt wird. |
TreatWarningsAsErrors |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, werden alle Warnungen als Fehler behandelt. Weitere Informationen hierzu finden Sie unter /warnaserror (Warnungen als Fehler behandeln) (C#-Compileroptionen). |
UseHostCompilerIfAvailable |
Optionaler Boolean-Parameter. Weist die Aufgabe auf, das prozessinterne Compilerobjekt zu verwenden, falls verfügbar. Wird nur von Visual Studio verwendet. |
Utf8Output |
Optionaler Boolean-Parameter. Protokolliert die Compilerausgabe mit UTF-8-Codierung. Weitere Informationen hierzu finden Sie unter /utf8output (Compilermeldungen mit UTF-8 anzeigen) (C#-Compileroptionen). |
WarningLevel |
Optionaler Int32-Parameter. Gibt die vom Compiler anzuzeigende Warnstufe an. Weitere Informationen hierzu finden Sie unter /warn (Warnstufe festlegen) (C#-Compileroptionen). |
WarningsAsErrors |
Optionaler String-Parameter. Gibt eine Liste mit Warnungen an, die als Fehler behandelt werden sollen. Weitere Informationen hierzu finden Sie unter /warnaserror (Warnungen als Fehler behandeln) (C#-Compileroptionen). Dieser Parameter überschreibt den TreatWarningsAsErrors-Parameter. |
WarningsNotAsErrors |
Optionaler String-Parameter. Gibt eine Liste mit Warnungen an, die nicht als Fehler behandelt werden sollen. Weitere Informationen hierzu finden Sie unter /warnaserror (Warnungen als Fehler behandeln) (C#-Compileroptionen). Dieser Parameter ist nur nützlich, wenn der TreatWarningsAsErrors-Parameter auf true festgelegt wird. |
WarningLevel |
Optionaler Int32-Parameter. Legt die entsprechende Warnstufe fest (0-4). Weitere Informationen finden Sie unter /warn (Warnstufe festlegen) (C#-Compileroptionen). |
Win32Icon |
Optionaler String-Parameter. Fügt eine ICO-Datei in die Assembly ein, wodurch die Ausgabedatei in Windows Explorer wie gewünscht angezeigt wird. Weitere Informationen finden Sie unter /win32icon (ICO-Datei importieren) (C#-Compileroptionen). |
Win32Resource |
Optionaler String-Parameter. Fügt eine Win32-Ressourcendatei (.res) in die Ausgabedatei ein. Weitere Informationen hierzu finden Sie unter /win32res (Win32-Ressourcendatei importieren) (C#-Compileroptionen). |
Beispiel
Im folgenden Beispiel wird die Csc-Aufgabe verwendet, um auf Grundlage der Quelldateien in der Compile-Elementauflistung eine ausführbare Datei zu kompilieren.
<CSC
Sources="@(Compile)"
OutputAssembly="$(AppName).exe"
EmitDebugInformation="true" />