Vbc-Aufgabe
Umschließt vbc.exe, womit folgendes erzeugt wird: ausführbare Dateien (.exe), Dynamic Link Library-Dateien (.dll) und Codemodule (. NETMODULE-Dateien). Weitere Informationen zu vbc.exe finden Sie unter Visual Basic-Compiler.
Parameter
In der folgenden Tabelle werden die Parameter der Vbc-Aufgabe beschrieben.
Parameter |
Beschreibung |
|---|---|
AdditionalLibPaths |
Optionaler String[]-Parameter. Gibt zusätzliche Ordner an, in denen nach den im References-Attribut angegebenen Assemblys gesucht werden soll. |
AddModules |
Optionaler String[]-Parameter. Bewirkt, dass der Compiler dem Projekt, das Sie gerade kompilieren, sämtliche Typinformationen aus den angegebenen Dateien bereitstellt. Dieser Parameter entspricht dem /addmodule-Schalter des vbc.exe-Compilers. |
BaseAddress |
Optionaler String-Parameter. Gibt die Basisadresse der DLL an. Dieser Parameter entspricht dem /baseaddress-Schalter des vbc.exe-Compilers. |
CodePage |
Optionaler Int32-Parameter. Gibt die für alle Quellcodedateien in der Kompilierung zu verwendende Codepage an. Dieser Parameter entspricht dem /codepage-Schalter des vbc.exe-Compilers. |
DebugType |
Optionaler String[]-Parameter. Bewirkt, dass der Compiler Debuginformationen generiert. Dieser Parameter kann die folgenden Werte aufweisen:
Der Standardwert ist full. Durch diesen wird das Anfügen eines Debuggers an das laufende Programm aktiviert. Der Wert pdbonly ermöglicht das Debuggen von Quellcode, wenn das Programm im Debugger gestartet wird. Der Code in Assemblersprache wird jedoch nur angezeigt, wenn das laufende Programm an den Debugger angefügt ist. Weitere Informationen hierzu finden Sie unter /debug (Visual Basic). |
DefineConstants |
Optionaler String[]-Parameter. Definiert Konstanten für die bedingte Kompilierung. Symbol/Wert-Paare werden durch Semikolons getrennt und mit der folgenden Syntax angegeben: symbol1=value1;symbol2=value2 Dieser Parameter entspricht dem /define-Schalter des vbc.exe-Compilers. |
DelaySign |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, fügt die Aufgabe den öffentlichen Schlüssel in die Assembly ein. Lautet der Wert false, signiert die Aufgabe die Assembly vollständig. Der Standardwert ist false. Dieser Parameter hat nur Auswirkungen, wenn er mit dem KeyFile-Parameter oder dem KeyContainer-Parameter verwendet wird. Dieser Parameter entspricht dem /delaysign-Schalter des vbc.exe-Compilers. |
DisabledWarnings |
Optionaler String-Parameter. Unterdrückt die angegebenen Warnungen. Sie müssen lediglich den numerischen Teil des Warnungsbezeichners angeben. Mehrere Warnungen werden durch Semikolons getrennt. Dieser Parameter entspricht dem /nowarn-Schalter des vbc.exe-Compilers. |
DocumentationFile |
Optionaler String-Parameter. Verarbeitet Dokumentationskommentare zu der angegebenen XML-Datei. Dieser Parameter überschreibt das GenerateDocumentation-Attribut. Weitere Informationen hierzu finden Sie unter /doc. |
EmitDebugInformation |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, generiert die Aufgabe Debuginformationen und fügt sie in eine PDB-Datei ein. Weitere Informationen hierzu finden Sie unter /debug (Visual Basic). |
ErrorReport |
Optionaler String-Parameter. Gibt an, wie die Aufgabe interne Compilerfehler melden soll. Dieser Parameter kann die folgenden Werte aufweisen:
Wenn prompt angegeben ist und ein interner Compilerfehler auftritt, wird der Benutzer aufgefordert anzugeben, ob die Fehlerdaten an Microsoft gesendet werden sollen. Wenn send angegeben ist und ein interner Compilerfehler auftritt, sendet die Aufgabe die Fehlerdaten an Microsoft. Der Standardwert ist none, d. h., Fehler werden nur in einer Textausgabe gemeldet. Dieser Parameter entspricht dem /errorreport-Schalter des vbc.exe-Compilers. |
FileAlignment |
Optionaler Int32-Parameter. Gibt die Ausrichtung der Abschnitte der Ausgabedatei in Bytes an. Dieser Parameter kann die folgenden Werte aufweisen:
Dieser Parameter entspricht dem /filealign-Schalter des vbc.exe-Compilers. |
GenerateDocumentation |
Optionaler Boolean-Parameter. Wenn der Wert true ist, werden Dokumentationsinformationen generiert und in eine XML-Datei eingefügt, deren Name dem der von der Aufgabe erstellten ausführbaren Datei oder Bibliothek entspricht. Weitere Informationen hierzu finden Sie unter /doc. |
Imports |
Optionaler ITaskItem[]-Parameter. Importiert Namespaces aus den angegebenen Elementauflistungen. Dieser Parameter entspricht dem /imports-Schalter des vbc.exe-Compilers. |
KeyContainer |
Optionaler String-Parameter. Gibt den Namen des Kryptografieschlüsselcontainers an. Dieser Parameter entspricht dem /keycontainer-Schalter des vbc.exe-Compilers. |
KeyFile |
Optionaler String-Parameter. Gibt den Namen der Datei an, die den kryptografischen Schlüssel enthält. Weitere Informationen hierzu finden Sie unter /keyfile. |
LangVersion |
Optionaler [String]-Parameter. Gibt die Sprachversion an, entweder "9"oder "10". |
LinkResources |
Optionaler ITaskItem[]-Parameter. Erstellt einen Link zu einer .NET Framework-Ressource in der Ausgabedatei. Die Ressourcendatei wird nicht in der Ausgabedatei platziert. Dieser Parameter entspricht dem /linkresource-Schalter des vbc.exe-Compilers. |
MainEntryPoint |
Optionaler String-Parameter. Gibt die Klasse oder das Modul an, die bzw. das die Sub Main-Prozedur enthält. Dieser Parameter entspricht dem /main-Schalter des vbc.exe-Compilers. |
ModuleAssemblyName |
Optionaler String-Parameter. Gibt die Assembly an, zu der dieses Modul gehört. |
NoConfig |
Optionaler Boolean-Parameter. Gibt an, dass der Compiler die Datei vbc.rsp nicht verwenden soll. Dieser Parameter entspricht dem /noconfig-Schalter des vbc.exe-Compilers. |
NoLogo |
Optionaler Boolean-Parameter. Wenn der Wert true lautet, wird die Anzeige der Compilerbannerinformationen unterdrückt. Dieser Parameter entspricht dem /nologo-Schalter des vbc.exe-Compilers. |
NoStandardLib |
Optionaler Boolean-Parameter. Bewirkt, dass der Compiler nicht auf die Standardbibliotheken verweist. Dieser Parameter entspricht dem /nostdlib-Schalter des vbc.exe-Compilers. |
NoVBRuntimeReference |
Optionaler Boolean-Parameter. Wird nur intern verwendet. Bei true wird der automatischer Verweis auf Microsoft.VisualBasic.dll vermieden. |
NoWarnings |
Optionaler Boolean-Parameter. Wenn der Wert true ist, unterdrückt die Aufgabe alle Warnungen. Weitere Informationen hierzu finden Sie unter /nowarn. |
Optimize |
Optionaler Boolean-Parameter. Wenn der Wert true ist, werden Compileroptimierungen aktiviert. Dieser Parameter entspricht dem /optimize-Schalter des vbc.exe-Compilers. |
OptionCompare |
Optionaler String-Parameter. Gibt an, wie Zeichenfolgenvergleiche durchgeführt werden. Dieser Parameter kann die folgenden Werte aufweisen:
Der Wert binary gibt an, dass die Aufgabe binäre Zeichenfolgenvergleiche verwendet. Der Wert text gibt an, dass die Aufgabe textbasierte Zeichenfolgenvergleiche verwendet. Der Standardwert dieses Parameters ist binary. Dieser Parameter entspricht dem /optioncompare-Schalter des vbc.exe-Compilers. |
OptionExplicit |
Optionaler Boolean-Parameter. Wenn der Wert true ist, müssen Variablen explizit deklariert werden. Dieser Parameter entspricht dem /optionexplicit-Schalter des vbc.exe-Compilers. |
OptionInfer |
Optionaler Boolean-Parameter. Wenn true, wird der Typrückschluss von Variablen ermöglicht. |
OptionStrict |
Optionaler Boolean-Parameter. Wenn der Wert true ist, erzwingt die Aufgabe strikte Typsemantik, um implizite Typkonvertierungen zu beschränken. Dieser Parameter entspricht dem /optionstrict-Schalter des vbc.exe-Compilers. |
OptionStrictType |
Optionaler String-Parameter. Gibt an, welche strikte Typsemantik eine Warnung generiert. Derzeit wird nur "custom" unterstützt. Dieser Parameter entspricht dem /optionstrict-Schalter des vbc.exe-Compilers. |
OutputAssembly |
Optionaler String-Ausgabeparameter. Gibt den Namen der Ausgabedatei an. Dieser Parameter entspricht dem /out-Schalter des vbc.exe-Compilers. |
Platform |
Optionaler String-Parameter. Gibt die von der Ausgabedatei verwendete Prozessorplattform an. Dieser Parameter kann den Wert x86, x64, Itanium oder anycpu aufweisen. Der Standardwert ist anycpu. Dieser Parameter entspricht dem /platform-Schalter des vbc.exe-Compilers. |
References |
Optionaler ITaskItem[]-Parameter. Bewirkt, dass die Aufgabe öffentliche Typinformationen von den angegebenen Elementen ins aktuelle Projekt importiert. Dieser Parameter entspricht dem /reference-Schalter des vbc.exe-Compilers. |
RemoveIntegerChecks |
Optionaler Boolean-Parameter. Wenn der Wert true ist, werden Überprüfungen auf Ganzzahlüberlauf deaktiviert. Der Standardwert ist false. Dieser Parameter entspricht dem /removeintchecks-Schalter des vbc.exe-Compilers. |
Resources |
Optionaler ITaskItem[]-Parameter. Bettet eine .NET Framework-Ressource in die Ausgabedatei ein. Dieser Parameter entspricht dem /resource-Schalter des vbc.exe-Compilers. |
ResponseFiles |
Optionaler ITaskItem[]-Parameter. Gibt die Antwortdatei an, die Befehle für diese Aufgabe enthält. Dieser Parameter entspricht der @ (Antwortdatei festlegen)-Option des vbc.exe-Compilers. |
RootNamespace |
Optionaler String-Parameter. Gibt den Stammnamespace für alle Typdeklarationen an. Dieser Parameter entspricht dem /rootnamespace-Schalter des vbc.exe-Compilers. |
SdkPath |
Optionaler String-Parameter. Gibt den Speicherort von mscorlib.dll und microsoft.visualbasic.dll an. Dieser Parameter entspricht dem /sdkpath-Schalter des vbc.exe-Compilers. |
Sources |
Optionaler ITaskItem[]-Parameter. Gibt eine oder mehrere Visual Basic-Quelldateien an. |
TargetCompactFramework |
Optionaler Boolean-Parameter. Wenn der Wert true ist, verwendet die Aufgabe .NET Compact Framework. Dieser Schalter entspricht dem /netcf-Schalter des vbc.exe-Compilers. |
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. Dieser Parameter entspricht dem /target-Schalter des vbc.exe-Compilers. |
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 (vbc.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 ist, werden alle Warnungen als Fehler behandelt. Weitere Informationen hierzu finden Sie unter /warnaserror (Visual Basic). |
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. Dieser Parameter entspricht dem /utf8output-Schalter des vbc.exe-Compilers. |
Verbosity |
Optionaler String-Parameter. Gibt den Ausführlichkeitsgrad der Compilerausgabe an. Der Ausführlichkeitsgrad kann Quiet, Normal (Standard) oder Verbose sein. |
WarningsAsErrors |
Optionaler String-Parameter. Gibt eine Liste mit Warnungen an, die als Fehler behandelt werden sollen. Weitere Informationen hierzu finden Sie unter /warnaserror (Visual Basic). 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 (Visual Basic). Dieser Parameter ist nur nützlich, wenn der TreatWarningsAsErrors-Parameter auf true festgelegt wird. |
Win32Icon |
Optionaler String-Parameter. Fügt eine ICO-Datei in die Assembly ein, wodurch die Ausgabedatei in Windows Explorer wie gewünscht angezeigt wird. Dieser Parameter entspricht dem /win32icon-Schalter des vbc.exe-Compilers. |
Win32Resources |
Optionaler String-Parameter. Fügt eine Win32-Ressourcendatei (.res) in die Ausgabedatei ein. Dieser Parameter entspricht dem /win32resource-Schalter des vbc.exe-Compilers. |
Hinweise
Zusätzlich zu den oben aufgeführten Parametern erbt diese Aufgabe Parameter von der ToolTaskExtension-Klasse, 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 ein Visual Basic-Projekt kompiliert.
<VBC
Sources="@(sources)"
Resources="strings.resources"
Optimize="true"
OutputAssembly="out.exe"/>