Csc-Aufgabe
Umschließt CSC.exe 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 |
Description |
|---|---|
AdditionalLibPaths |
Optionaler String[]-Parameter. Gibt zusätzliche Verzeichnisse an, in denen Verweise gesucht werden sollen.Weitere Informationen finden Sie unter /lib (C#-Compileroptionen). |
AddModules |
Optionaler String-Parameter. Gibt ein oder mehrere Module an, die Bestandteil der Assembly sein sollen.Weitere Informationen finden Sie unter /addmodule (C#-Compileroptionen). |
AllowUnsafeBlocks |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, wird Code kompiliert, in dem das Schlüsselwort unsafe verwendet wird.Weitere Informationen finden Sie unter /unsafe (C#-Compileroptionen). |
ApplicationConfiguration |
Optionaler String-Parameter. Gibt die Anwendungskonfigurationsdatei an, die Bindungseinstellungen für Assemblys enthält. |
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 finden Sie unter /baseaddress (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 (C#-Compileroptionen). |
CodePage |
Optionaler Int32-Parameter. Gibt für alle Quellcodedateien in der Kompilierung die zu verwendende Codepage an.Weitere Informationen finden Sie unter /codepage (C#-Compileroptionen). |
DebugType |
Optionaler String-Parameter. Gibt den Debugtyp an.DebugType kann full oder pdbonly sein.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 finden Sie unter /debug (C#-Compileroptionen). |
DefineConstants |
Optionaler String-Parameter. Definiert Präprozessorsymbole.Weitere Informationen finden Sie unter /define (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 finden Sie unter /delaysign (C#-Compileroptionen). |
DisabledWarnings |
Optionaler String-Parameter. Gibt die Liste der Warnungen an, die deaktiviert werden sollen.Weitere Informationen finden Sie unter /nowarn (C#-Compileroptionen). |
DocumentationFile |
Optionaler String-Parameter. Verarbeitet Dokumentationskommentare zu einer XML-Datei.Weitere Informationen finden Sie unter /doc (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 finden Sie unter /debug (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 (C#-Compileroptionen). |
FileAlignment |
Optionaler Int32-Parameter. Gibt die Größe der Abschnitte in der Ausgabedatei an.Weitere Informationen finden Sie unter /filealign (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 finden Sie unter /fullpaths (C#-Compileroptionen). |
KeyContainer |
Optionaler String-Parameter. Gibt den Namen des Kryptografieschlüsselcontainers an.Weitere Informationen finden Sie unter /keycontainer (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 (C#-Compileroptionen). |
LangVersion |
Optionaler String-Parameter. Gibt an, welche Sprachversion verwendet werden soll.Weitere Informationen finden Sie unter /langversion (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 finden Sie unter /linkresource (C#-Compileroptionen). |
MainEntryPoint |
Optionaler String-Parameter. Gibt den Speicherort der Main-Methode an.Weitere Informationen finden Sie unter /main (C#-Compileroptionen). |
ModuleAssemblyName |
Optionaler String-Parameter. Gibt den Namen der Assembly an, die dieses Modul beinhalten wird. |
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 (C#-Compileroptionen). |
NoLogo |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, wird die Anzeige der Compilerbannerinformationen unterdrückt.Weitere Informationen finden Sie unter /nologo (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 (C#-Compileroptionen). |
NoWin32Manifest |
Optionaler Boolean-Parameter. Bei true wird das Win32-Standardmanifest nicht aufgenommen. |
Optimize |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, werden Optimierungen aktiviert.Durch den Wert false werden Optimierungen deaktiviert.Weitere Informationen finden Sie unter /optimize (C#-Compileroptionen). |
OutputAssembly |
Optionaler String-Ausgabeparameter. Gibt den Namen der Ausgabedatei an.Weitere Informationen finden Sie unter /out (C#-Compileroptionen). |
PdbFile |
Optionaler String-Parameter. Gibt den Dateinamen der Debuginformationen an.Der Standardname ist der Ausgabedateiname mit der Erweiterung .pdb. |
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 (C#-Compileroptionen). |
References |
Optionaler ITaskItem[]-Parameter. Bewirkt, dass die Aufgabe öffentliche Typinformationen von den angegebenen Elementen ins aktuelle Projekt importiert.Weitere Informationen finden Sie unter /reference (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 finden Sie unter /resource (C#-Compileroptionen). |
ResponseFiles |
Optionaler String-Parameter. Gibt die Antwortdatei an, die Befehle für diese Aufgabe enthält.Weitere Informationen finden Sie unter @ (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 finden Sie unter /target (C#-Compileroptionen). |
TreatWarningsAsErrors |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, werden alle Warnungen als Fehler behandelt.Weitere Informationen finden Sie unter /warnaserror (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 finden Sie unter /utf8output (C#-Compileroptionen). |
WarningLevel |
Optionaler Int32-Parameter. Gibt die vom Compiler anzuzeigende Warnstufe an.Weitere Informationen finden Sie unter /warn (C#-Compileroptionen). |
WarningsAsErrors |
Optionaler String-Parameter. Gibt eine Liste mit Warnungen an, die als Fehler behandelt werden sollen.Weitere Informationen finden Sie unter /warnaserror (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 finden Sie unter /warnaserror (C#-Compileroptionen). Dieser Parameter ist nur nützlich, wenn der TreatWarningsAsErrors-Parameter auf true festgelegt wird. |
Win32Icon |
Optionaler String-Parameter. Fügt eine ICO-Datei in der Assembly, die der Ausgabedatei die gewünschte Darstellung im Datei-Explorer gibt.Weitere Informationen finden Sie unter /win32icon (C#-Compileroptionen). |
Win32Manifest |
Optionaler String-Parameter. Gibt das Win32-Manifest an, das aufgenommen werden soll. |
Win32Resource |
Optionaler String-Parameter. Fügt eine Win32-Ressourcendatei (.res) in die Ausgabedatei ein.Weitere Informationen finden Sie unter /win32res (C#-Compileroptionen). |
Hinweise
Zusätzlich zu den oben aufgeführten Parametern erbt diese Aufgabe Parameter von der Microsoft.Build.Tasks.ManagedCompiler-Klasse, die von der ToolTaskExtension-Klasse erbt, die selbst von der ToolTask-Klasse erbt.Eine Liste mit diesen zusätzlichen Parametern und ihren Beschreibungen finden Sie unter ToolTaskExtension-Basisklasse.
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" />