Vbc-Aufgabe

  • Artikel

Umschließt die Datei vbc.exe, die ausführbare Dateien (EXE), Dynamic Link Libraries (DLL) oder Codemodule (NETMODULE) produziert. Weitere Informationen zu vbc.exe finden Sie unter Visual Basic-Befehlszeilencompiler.

Parameter

In der folgenden Tabelle werden die Parameter der Vbc -Aufgabe beschrieben.

Parameter Beschreibung
AdditionalLibPaths Optionaler String[]-Parameter.

Gibt weitere Ordner an, in denen nach im Verweisattribut angegebenen Assemblys gesucht werden soll
AddModules Optionaler String[]-Parameter.

Bewirkt, dass der Compiler dem Projekt, das Sie aktuell kompilieren, sämtliche Typinformationen aus den angegebenen Dateien bereitstellt. Dieser Parameter entspricht der Option -addmodule des Compilers vbc.exe.
BaseAddress Optionaler String-Parameter.

Gibt die Basisadresse einer DLL an. Dieser Parameter entspricht der Option -baseaddress des Compilers vbc.exe.
CodePage Optionaler Int32-Parameter.

Gibt die für alle Quellcodedateien in der Kompilierung die zu verwendende Codepage an. Dieser Parameter entspricht der Option -codepage des Compilers vbc.exe.
DebugType Optionaler String[]-Parameter.

Veranlasst, dass der Compiler Debuginformationen generiert. Dieser Parameter kann die folgenden Werte aufweisen:

- full
- pdbonly

Der Standardwert ist full, wodurch ermöglicht wird, einen Debugger an ein ausgeführtes Programm anzufügen. Der Wert pdbonly macht das Debuggen von Quellcode möglich, wenn das Programm im Debugger gestartet wird. Der Assembler wird jedoch nur angezeigt, wenn das aktive Programm an den Debugger angefügt ist. Weitere Informationen 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=Wert1;Symbol2=Wert2

Dieser Parameter entspricht der Option -define des Compilers vbc.exe.
DelaySign Optionaler Boolean-Parameter.

Ist der Wert true, legt die Aufgabe den öffentlichen Schlüssel in der Assembly ab. Ist der Wert false, signiert die Aufgabe die Assembly vollständig. Der Standardwert ist false. Dieser Parameter hat keine Auswirkung, es sei denn, er wird mit den Parametern KeyFile oder KeyContainer verwendet. Dieser Parameter entspricht der Option -delaysign des Compilers vbc.exe.
Deterministic Optionaler Boolean-Parameter.

Wenn dieser auf true festgelegt ist, gibt der Compiler eine Assembly aus, deren Inhalt im Binärformat über Kompilierungen identisch ist, wenn die Eingaben identisch sind.

Weitere Informationen finden Sie unter -deterministic.
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 der Option -nowarn des Compilers vbc.exe.
DocumentationFile Optionaler String-Parameter.

Verarbeitet Dokumentationskommentare zu der angegebenen XML-Datei. Dieser Parameter überschreibt das GenerateDocumentation-Attribut. Weitere Informationen finden Sie unter -doc.
EmitDebugInformation Optionaler Boolean-Parameter.

Ist der Wert true, generiert die Aufgabe Debuginformationen und platziert sie in einer Programmdatenbankdatei (PDB-Datei). Weitere Informationen finden Sie unter -debug (Visual Basic).
ErrorReport Optionaler String-Parameter.

Gibt an, wie interne Compilerfehler von der Aufgabe gemeldet werden sollen. Dieser Parameter kann die folgenden Werte aufweisen:

- prompt
- send
- none

Wenn prompt angegeben ist und ein interner Compilerfehler auftritt, wird der Benutzer gefragt, ob die Fehlerdaten an Microsoft gesendet werden sollen.

Wenn send angegeben ist und ein interner Compilerfehler auftritt, sendet die Aufgabe Fehlerdaten an Microsoft.

Der Standardwert ist none, der Fehler im nur als Textausgabe berichtet.

Dieser Parameter entspricht der Option -errorreport des Compilers vbc.exe.
FileAlignment Optionaler Int32-Parameter.

Gibt die Ausrichtung der Abschnitte der Ausgabedatei in Bytes an. Dieser Parameter kann die folgenden Werte aufweisen:

- 512
- 1024
- 2048
- 4096
- 8192

Dieser Parameter entspricht der Option -filealign des Compilers vbc.exe.
GenerateDocumentation Optionaler Boolean-Parameter.

Wenn der Wert true lautet, werden Dokumentationsinformationen generiert und zusammen mit dem Namen der ausführbaren Datei oder der Bibliothek, die von der Aufgabe erstellt wurde, in einer XML-Datei gespeichert. Weitere Informationen finden Sie unter -doc.
Imports Optionaler ITaskItem[]-Parameter

Importiert Namespaces aus den angegebenen Auflistungen. Dieser Parameter entspricht der Option -imports des Compilers vbc.exe.
KeyContainer Optionaler String-Parameter.

Gibt den Namen des kryptografischen Schlüsselcontainers an. Dieser Parameter entspricht der Option -keycontainer des Compilers vbc.exe.
KeyFile Optionaler String-Parameter.

Gibt den Dateinamen mit dem kryptografischen Schlüssel an. Weitere Informationen finden Sie unter -keyfile.
LangVersion Optionaler System.String-Parameter.

Gibt die Sprachversion (z.B. 15.5) an.
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 der Option -linkresource des Compilers vbc.exe.
MainEntryPoint Optionaler String-Parameter.

Gibt die Klasse oder das Modul mit dem Speicherort der Sub Main-Prozedur an. Dieser Parameter entspricht der Option -main des Compilers vbc.exe.
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 Parameter -noconfig des Compilers vbc.exe.
NoLogo Optionaler Boolean-Parameter.

Wenn der Wert true ist, werden die Compilerbannerinformationen unterdrückt. Dieser Parameter entspricht der Option -nologo des Compilers vbc.exe.
NoStandardLib Optionaler Boolean-Parameter.

Bewirkt, dass der Compiler nicht auf die Standardbibliotheken verweist. Dieser Parameter entspricht der Option -nostdlib des Compilers vbc.exe.
NoVBRuntimeReference Optionaler Boolean-Parameter.

Nur zur internen Verwendung. Wenn der Wert TRUE ist, wird der automatische Verweis auf Microsoft.VisualBasic.dll verhindert.
NoWarnings Optionaler Boolean-Parameter.

Wenn dieser auf true festgelegt ist, unterdrückt die Aufgabe alle Warnungen. Weitere Informationen finden Sie unter -nowarn.
Optimize Optionaler Boolean-Parameter.

Wenn der Wert true ist, werden Compileroptimierungen aktiviert. Dieser Parameter entspricht der Option -optimize des Compilers vbc.exe.
OptionCompare Optionaler String-Parameter.

Gibt an, wie Zeichenfolgenvergleiche durchgeführt werden. Dieser Parameter kann die folgenden Werte aufweisen:

- binary
- text

Der Wert binary gibt an, dass die Aufgabe binäre Zeichenfolgenvergleiche verwendet. Der Wert text gibt an, dass die Aufgabe Textzeichenfolgenvergleiche verwendet. Der Standardwert dieses Parameters ist binary. Dieser Parameter entspricht der Option -optioncompare des Compilers vbc.exe.
OptionExplicit Optionaler Boolean-Parameter.

Wenn der Wert true ist, ist die explizite Deklaration von Variablen erforderlich. Dieser Parameter entspricht der Option -optionexplicit des Compilers vbc.exe.
OptionInfer Optionaler Boolean-Parameter.

Wenn der Wert true ist, werden Typrückschlüsse von Variablen zugelassen.
OptionStrict Optionaler Boolean-Parameter.

Wenn der Wert true ist, erzwingt die Aufgabe eine strikte Typsemantik, um implizite Typkonvertierungen zu beschränken. Dieser Parameter entspricht der Option -optionstrict des Compilers vbc.exe.
OptionStrictType Optionaler String-Parameter.

Gibt an, welche strikte Typsemantik eine Warnung generiert. Derzeit wird nur „custom“ unterstützt. Dieser Parameter entspricht der Option -optionstrict des Compilers vbc.exe.
OutputAssembly Optionaler String-Ausgabeparameter.

Gibt den Namen der Ausgabedatei an. Dieser Parameter entspricht der Option -out des Compilers vbc.exe.
Platform Optionaler String-Parameter.

Gibt die Prozessorplattform an, die das Ziel der Ausgabedatei darstellen soll. Dieser Parameter kann den Wert x86, x64, Itanium oder anycpu aufweisen. Der Standardwert ist anycpu. Dieser Parameter entspricht der Option -platform des Compilers vbc.exe.
References Optionaler ITaskItem[]-Parameter

Bewirkt, dass die Aufgabe öffentliche Typinformationen aus den angegebenen Elementen in das aktuelle Projekt importiert. Dieser Parameter entspricht der Option -reference des Compilers vbc.exe.
RemoveIntegerChecks Optionaler Boolean-Parameter.

Wenn der Wert true ist, werden die Fehlerüberprüfungen auf Ganzzahlüberlauf deaktiviert. Der Standardwert ist false. Dieser Parameter entspricht der Option -removeintchecks des Compilers vbc.exe.
Resources Optionaler ITaskItem[]-Parameter

Bettet eine .NET Framework-Ressource in die Ausgabedatei ein. Dieser Parameter entspricht der Option -resource des Compilers vbc.exe.
ResponseFiles Optionaler ITaskItem[]-Parameter

Gibt die Antwortdatei an, die Befehle für den die Aufgabe enthalten. Dieser Parameter entspricht der Option @ (Antwortdatei festlegen) des Compilers vbc.exe.
RootNamespace Optionaler String-Parameter.

Gibt den Stammnamespace für alle Typdeklarationen an. Dieser Parameter entspricht der Option -rootnamespace des Compilers vbc.exe.
SdkPath Optionaler String-Parameter.

Gibt den Speicherort von mscorlib.dll und microsoft.visualbasic.dll an. Dieser Parameter entspricht der Option -sdkpath des Compilers vbc.exe.
Sources Optionaler ITaskItem[]-Parameter

Gibt mindestens eine Visual Basic-Quelldatei an.
TargetCompactFramework Optionaler Boolean-Parameter.

Bei Festlegung auf true wird das Ziel auf das .NET Compact Framework ausgerichtet. Dieser Parameter entspricht der Option -netcf des Compilers vbc.exe.
TargetType Optionaler String-Parameter.

Gibt das Dateiformat der Ausgabedatei an. Dieser Parameter kann unterschiedliche Werte aufweisen: library erstellt eine Codebibliothek, exe erstellt eine Konsolenanwendung, module erstellt ein Modul, und winexe erstellt ein Windows-Programm. Der Standardwert ist library. Dieser Parameter entspricht der Option -target des Compilers vbc.exe.
Timeout Optionaler Int32-Parameter.

Gibt die Zeitdauer in Millisekunden an, nach der die ausführbare Datei der Aufgabe beendet wird. Der Standardwert ist Int.MaxValue. Dieser gibt an, dass es kein Zeitlimit gibt.
ToolPath Optionaler String-Parameter.

Gibt den Speicherort an, von dem aus die Aufgabe die zugrunde liegende ausführbare Datei (vbc.exe) lädt. Wenn dieser Parameter nicht angegeben ist, verwendet die Aufgabe den SDK-Installationspfad der Version des Frameworks, die von MSBuild ausgeführt wird.
TreatWarningsAsErrors Optionaler Boolean-Parameter.

Wenn der Wert true ist, werden alle Warnungen wie Fehler behandelt. Weitere Informationen finden Sie unter -warnaserror (Visual Basic).
UseHostCompilerIfAvailable Optionaler Boolean-Parameter.

Weist die Aufgabe an, das prozessinterne Compilerobjekt (falls verfügbar) zu verwenden. Wird nur von Visual Studio verwendet.
Utf8Output Optionaler Boolean-Parameter.

Protokolliert die Compilerausgabe mit UTF-8-Codierung. Dieser Parameter entspricht der Option -utf8output des Compilers vbc.exe.
Verbosity Optionaler String-Parameter.

Gibt den Ausführlichkeitsgrad der Ausgabe des Compilers an. Der Ausführlichkeitsgrad kann Quiet, Normal (Standard) oder Verbose lauten.
WarningsAsErrors Optionaler String-Parameter.

Gibt eine Liste mit Warnungen an, die als Fehler behandelt werden sollen. Weitere Informationen 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 finden Sie unter -warnaserror (Visual Basic).

Dieser Parameter ist nur dann nützlich, wenn der TreatWarningsAsErrors-Parameter auf true gesetzt ist.
Win32Icon Optionaler String-Parameter.

Fügt der Assembly eine ICO-Datei hinzu, die der Ausgabedatei im Datei-Explorer das gewünschte Aussehen verleiht. Dieser Parameter entspricht der Option -win32icon des Compilers vbc.exe.
Win32Resources Optionaler String-Parameter.

Fügt eine Win32-Ressource (RES-Datei) in die Ausgabedatei ein. Dieser Parameter entspricht der Option -win32resource des Compilers vbc.exe.

ToolTaskExtension-Parameter

Dieser Task erbt aus der ToolTaskExtension-Klasse, die aus der ToolTask-Klasse erbt, welche wiederum aus der Task-Klasse erbt. Diese Vererbungskette fügt verschiedene Parameter zu den Aufgaben hinzu, die aus ihnen abgeleitet werden.

In der folgenden Tabelle werden die Parameter der Basisklassen beschrieben:

Parameter Beschreibung
EchoOff Optionaler bool-Parameter.

Bei der Festlegung auf true gibt diese Aufgabe /Q an die Befehlszeile cmd.exe so weiter, dass die Befehlszeile nicht zu „stdout“ kopiert wird.
EnvironmentVariables Optionaler String-Arrayparameter.

Array aus Umgebungsvariablendefinitionen, getrennt durch Semikolons. Jede Definition sollte einen Namen und einen Wert für eine Umgebungsvariable angeben, getrennt durch ein Gleichheitszeichen. Diese Variablen werden an die erstellte ausführbare Datei zusätzlich zum regulären Umgebungsblock oder zum ausgewählten Überschreiben hinzugefügt. Beispiel: Variable1=Value1;Variable2=Value2.
ExitCode Optionaler schreibgeschützter Int32-Ausgabeparameter.

Gibt den durch den ausgeführten Befehl bereitgestellten Exitcode an. Wenn bei der Aufgabe Fehler protokolliert wurden, der Prozess jedoch über einen Exitcode von „0“ (Erfolg) verfügt hat, wird dies auf „-1“ festgelegt.
LogStandardErrorAsError Optionaler bool-Parameter.

Wenn true gegeben ist, werden alle im Standardfehlerstream empfangenen Meldungen als Fehler protokolliert.
StandardErrorImportance Optionaler String-Parameter.

Wichtigkeit, mit der Text aus dem Standardfehlerstream protokolliert wird.
StandardOutputImportance Optionaler String-Parameter.

Wichtigkeit, mit der Text aus dem Standardausgabestream protokolliert wird.
Timeout Optionaler Int32-Parameter.

Gibt die Zeitdauer in Millisekunden an, nach der die ausführbare Datei der Aufgabe beendet wird. Der Standardwert ist Int.MaxValue. Dieser gibt an, dass es kein Zeitlimit gibt. Das Timeout in Millisekunden.
ToolExe Optionaler string-Parameter.

Projekte implementieren dies möglicherweise zum Überschreiben eines ToolName. Aufgaben überschreiben dies möglicherweise zum Beibehalten des ToolName.
ToolPath Optionaler string-Parameter.

Gibt den Speicherort an, von wo aus die Aufgabe die zugrunde liegende ausführbare Datei lädt. Wenn dieser Parameter nicht angegeben ist, verwendet die Aufgabe den SDK-Installationspfad der Version des Frameworks, die von MSBuild ausgeführt wird.
UseCommandProcessor Optionaler bool-Parameter.

Wenn die Festlegung auf true gegeben ist, erstellt diese Aufgabe eine Batchdatei für die Befehlszeile und führt sie aus, indem der Befehl nicht direkt ausgeführt wird, sondern der Befehlsprozessor verwendet wird.
YieldDuringToolExecution Optionaler bool-Parameter.

Bei der Festlegung auf true ergibt diese Aufgabe den Knoten, wenn dessen Aufgabe ausgeführt wird.

Beispiel

Im folgenden Beispiel wird ein Visual Basic-Projekt kompiliert.

<VBC
   Sources="@(sources)"
   Resources="strings.resources"
   Optimize="true"
   OutputAssembly="out.exe"/>

Siehe auch