Freigeben über

Csc-Aufgabe

  • Artikel

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:

csc /r:LS1=MyCodeLibrary.dll /r:LS2=MyCodeLibrary2.dll *.cs

würden Sie Folgendes verwenden:

<Reference Include="MyCodeLibrary">
  <Aliases>LS1</Aliases>
</Reference>

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" />

Siehe auch

Konzepte

MSBuild-Aufgaben

Weitere Ressourcen

Referenz zu MSBuild-Aufgaben