Kompilierungsseite, Project Designer (Visual Basic)
Anmerkung
Diese Seite bezieht sich auf die Project Designer-Oberfläche in Visual Studio 2019 und für .NET Framework-Projekte mit Visual Studio 2022.
Verwenden Sie die Seite Kompilieren des Project-Designers, um Kompilierungsanweisungen anzugeben. Sie können auch erweiterte Compileroptionen und Vorabbuild- oder Postbuildereignisse auf dieser Seite angeben.
Um auf die Seite Kompilieren zuzugreifen, wählen Sie im Projektmappen-Explorereinen Projektknoten (nicht den Projektmappenknoten) aus. Wählen Sie dann Project, Eigenschaften auf der Menüleiste aus. Wenn der Project Designer angezeigt wird, klicken Sie auf die Registerkarte Kompilieren.
Anmerkung
Auf Ihrem Computer werden möglicherweise unterschiedliche Namen oder Speicherorte für einige der Visual Studio-Benutzeroberflächenelemente in diesem Artikel angezeigt. Möglicherweise verwenden Sie eine andere Edition von Visual Studio oder andere Umgebungseinstellungen. Weitere Informationen finden Sie unter Personalisieren der IDE-.
Konfiguration und Plattform
Mit den folgenden Einstellungen können Sie die Konfiguration und Plattform auswählen, die angezeigt oder geändert werden soll.
Anmerkung
Mit vereinfachten Buildkonfigurationen bestimmt das Projektsystem, ob eine Debug- oder Releaseversion erstellt werden soll. Daher werden die listen Configuration und Platform nicht angezeigt.
Configuration
Gibt an, welche Konfigurationseinstellungen angezeigt oder geändert werden sollen. Die Einstellungen sind Debug- (Standard), Release-oder Alle Konfigurationen. Weitere Informationen finden Sie unter Grundlegendes zu Buildkonfigurationen und How to: Create and Edit Configurations.
Plattform-
Gibt an, welche Plattformeinstellungen angezeigt oder geändert werden sollen. Sie können Any CPU (Standard), x64-oder x86-angeben.
Compilerkonfigurationsoptionen
Mit den folgenden Einstellungen können Sie die Compilerkonfigurationsoptionen festlegen.
Buildausgabepfad
Gibt den Speicherort der Ausgabedateien für die Konfiguration dieses Projekts an. Geben Sie den Pfad der Buildausgabe in dieses Feld ein, oder klicken Sie auf die Schaltfläche Durchsuchen, um einen Pfad auszuwählen. Beachten Sie, dass der Pfad relativ ist; Wenn Sie einen absoluten Pfad eingeben, wird er als relativ gespeichert. Der Standardpfad ist "bin\Debug\" oder "bin\Release\".
Mit vereinfachten Buildkonfigurationen bestimmt das Projektsystem, ob eine Debug- oder Releaseversion erstellt werden soll. Der Befehl Build aus dem Menü Debuggen (F5) platziert den Build unabhängig vom angegebenen Ausgabe pfad im Debugspeicherort. Der Befehl Build aus dem Menü Build fügt ihn jedoch an die von Ihnen angegebene Position ein.
Option explizite
Gibt an, ob die implizite Deklaration von Variablen zulässig ist. Wählen Sie Bei aus, um eine explizite Deklaration von Variablen zu erfordern. Dies bewirkt, dass der Compiler Fehler meldet, wenn Variablen nicht deklariert werden, bevor sie verwendet werden. Wählen Sie Aus aus, um die implizite Deklaration von Variablen zuzulassen.
Diese Einstellung entspricht der /optionexplicit Compileroption.
Wenn eine Quellcodedatei eine Option Explicit Statemententhält, überschreibt der On- oder Off-Wert in der Anweisung die Einstellung Option Explicit auf der Kompilierungsseite.
Wenn Sie ein neues Projekt erstellen, wird die Einstellung Option Explicit auf der Kompilierungsseite auf den Wert der Einstellung Option Explicit im Dialogfeld Optionen festgelegt. Um die Einstellung in diesem Dialogfeld anzuzeigen oder zu ändern, klicken Sie im Menü Extras auf Optionen. Erweitern Sie im Dialogfeld OptionenProjekte und Lösungen, und klicken Sie dann auf VB-Standardwerte. Die anfängliche Standardeinstellung Option Explicit in VB Defaults ist On.
Das Festlegen Option Explicit auf Off ist im Allgemeinen keine bewährte Methode. Sie könnten einen Variablennamen an einem oder mehreren Speicherorten falsch geschrieben haben, was zu unerwarteten Ergebnissen führen würde, wenn das Programm ausgeführt wird.
Option strict
Gibt an, ob strenge Typsemantik erzwungen werden soll. Wenn Option Strict auf ist, verursachen die folgenden Bedingungen einen Kompilierungsfehler:
Implizite Verengungskonvertierungen
Verspätete Bindung
Implizite Eingabe, die zu einem
ObjectTyp führt
Implizite Verengungsfehler treten auf, wenn eine implizite Datentypkonvertierung vorliegt, bei der es sich um eine schmale Konvertierung handelt. Weitere Informationen finden Sie unter Option Strict Statement, Implizite und explizite Konvertierungenund Verbreitern und Einschränken von Konvertierungen.
Ein Objekt ist spät gebunden, wenn es einer Eigenschaft oder Methode einer Variablen zugewiesen wird, die als Typ Objectdeklariert ist. Weitere Informationen finden Sie unter Option Strict Statement und Early and Late Binding.
Implizite Objekttypfehler treten auf, wenn ein entsprechender Typ für eine deklarierte Variable nicht abgeleitet werden kann, sodass ein Typ von Object abgeleitet wird. Dies tritt in erster Linie auf, wenn Sie eine Dim-Anweisung verwenden, um eine Variable zu deklarieren, ohne eine As-Klausel zu verwenden, und Option Infer deaktiviert ist. Weitere Informationen finden Sie unter Option Strict-Anweisung, Option Infer-Anweisungund der Visual Basic Language Specification.
Die Einstellung Option Strict entspricht der /optionstrict Compileroption.
Wenn eine Quellcodedatei eine Option Strict-Anweisungenthält, überschreibt der On- oder Off-Wert in der Anweisung die Einstellung Option Strict auf der Kompilierungsseite.
Wenn Sie ein Projekt erstellen, wird die Einstellung Option Strict auf der seite Kompilieren auf den Wert der Einstellung Option Strict im Dialogfeld Optionen festgelegt. Um die Einstellung in diesem Dialogfeld anzuzeigen oder zu ändern, klicken Sie im Menü Extras auf Optionen. Erweitern Sie im Dialogfeld OptionenProjekte und Lösungen, und klicken Sie dann auf VB-Standardwerte. Die anfängliche Standardeinstellung von Option Strict in VB Defaults ist Aus.
Option Strict Individual Warnings
Die Warnungskonfigurationen Abschnitt der Kompilierungsseite verfügt über Einstellungen, die den drei Bedingungen entsprechen, die einen Kompilierzeitfehler verursachen, wenn Option Strict aktiviert ist. Im Folgenden sind die folgenden Einstellungen aufgeführt:
implizite Konvertierung
verspätete Bindung; Der Aufruf kann zur Laufzeit fehlschlagen
Impliziter Typ; objekt angenommen
Wenn Sie Option Strict auf Onfestlegen, werden alle drei dieser Warnungskonfigurationseinstellungen auf Fehler-festgelegt. Wenn Sie Option Strict auf Offfestlegen, werden alle drei Einstellungen auf Nonefestgelegt.
Sie können jede Warnungskonfigurationseinstellung einzeln in Keine, Warnungoder Fehler-ändern. Wenn alle drei Warnungskonfigurationseinstellungen auf Fehler-festgelegt sind, wird On im Feld Option strict angezeigt. Wenn alle drei auf Keinefestgelegt sind, wird in diesem Feld Off angezeigt. Bei einer anderen Kombination dieser Einstellungen wird (benutzerdefinierte) angezeigt.
Option compare
Gibt den Typ des zu verwendenden Zeichenfolgenvergleichs an. Wählen Sie Binary aus, um den Compiler anzuweisen, binäre Zeichenfolgenvergleiche mit Groß-/Kleinschreibung zu verwenden. Wählen Sie Text- aus, um gebietsschemaspezifische Zeichenfolgenvergleiche mit Groß-/Kleinschreibung zu verwenden.
Diese Einstellung entspricht der /optioncompare Compileroption.
Wenn eine Quellcodedatei eine Option Compare-Anweisungenthält, überschreibt der Binary- oder Text-Wert in der Anweisung die Einstellung Option Compare auf der Kompilierungsseite.
Wenn Sie ein Projekt erstellen, wird die Einstellung Option Compare auf der Seite Kompilieren auf den Wert der Einstellung Option Compare im Dialogfeld Optionen festgelegt. Um die Einstellung in diesem Dialogfeld anzuzeigen oder zu ändern, klicken Sie im Menü Extras auf Optionen. Erweitern Sie im Dialogfeld OptionenProjekte und Lösungen, und klicken Sie dann auf VB-Standardwerte. Die anfängliche Standardeinstellung von Option Compare in VB Defaults ist Binary.
Option
Gibt an, ob lokale Typinferenz in Variablendeklarationen zugelassen werden soll. Wählen Sie Bei aus, um die Verwendung des lokalen Typs zuzulassen. Wählen Sie Aus aus, um den lokalen Typabschluss zu blockieren.
Diese Einstellung entspricht der /optioninfer Compileroption.
Wenn eine Quellcodedatei eine Option Infer-Anweisungenthält, überschreibt der On- oder Off-Wert in der Anweisung die Einstellung Option Infer auf der Kompilierungsseite.
Wenn Sie ein Projekt erstellen, wird die Einstellung Option Infer auf der seite kompilieren auf den Wert der Einstellung Option Infer im Dialogfeld Optionen festgelegt. Um die Einstellung in diesem Dialogfeld anzuzeigen oder zu ändern, klicken Sie im Menü Extras auf Optionen. Erweitern Sie im Dialogfeld OptionenProjekte und Lösungen, und klicken Sie dann auf VB-Standardwerte. Die anfängliche Standardeinstellung von Option Infer in VB-Standardwerten ist On.
ZIEL-CPU-
Gibt den Prozessor an, der von der Ausgabedatei adressiert werden soll. Geben Sie x86- für einen beliebigen intelkompatiblen 32-Bit-Prozessor an, x64- für jeden 64-Bit-Intel-kompatiblen Prozessor, ARM- für jeden ARM-Prozessor oder Jeder CPU-, um anzugeben, dass jeder Prozessor akzeptabel ist. Jeder CPU- ist der Standardwert für neue Projekte, da die Anwendung auf der größten Anzahl von Hardwaretypen ausgeführt werden kann.
Weitere Informationen finden Sie unter /platform (Visual Basic).
Prefer 32-Bit-
Wenn das Kontrollkästchen Prefer32-Bit- aktiviert ist, wird die Anwendung sowohl in 32-Bit- als auch in 64-Bit-Versionen von Windows als 32-Bit-Anwendung ausgeführt. Andernfalls wird die Anwendung als 32-Bit-Anwendung in 32-Bit-Versionen von Windows und als 64-Bit-Anwendung in 64-Bit-Versionen von Windows ausgeführt.
Die Ausführung als 64-Bit-Anwendung verdoppelt die Zeigergröße und kann Kompatibilitätsprobleme mit Bibliotheken verursachen, die ausschließlich 32-Bit sind. Es ist sinnvoll, eine Anwendung nur als 64-Bit auszuführen, wenn sie erheblich schneller ausgeführt wird oder mehr als 4 GB Arbeitsspeicher benötigt.
Dieses Kontrollkästchen ist nur verfügbar, wenn alle folgenden Bedingungen erfüllt sind:
Auf der Kompilierungsseitewird die Liste Ziel-CPU- auf Any CPUfestgelegt.
Auf der Anwendungsseitegibt der Anwendungstyp Liste an, dass das Projekt eine Anwendung ist.
Auf der Anwendungsseitegibt die Liste zielframework das .NET Framework 4.5 an.
Warnungskonfigurationen
In dieser Tabelle sind Buildbedingungen und die entsprechende Benachrichtigungsebene None, Warningoder Error aufgeführt.
Standardmäßig werden alle Compilerwarnungen während der Kompilierung zur Aufgabenliste hinzugefügt. Wählen Sie Alle Warnungen deaktivieren aus, um den Compiler anzuweisen, Warnungen oder Fehler nicht auszustellen. Wählen Sie Alle Warnungen als Fehler behandeln, wenn der Compiler Warnungen als Fehler behandeln soll, die behoben werden müssen.
Alle Warnungen deaktivieren
Gibt an, ob der Compiler Benachrichtigungen ausstellen kann, wie in der tabelle Bedingung und Benachrichtigung weiter oben in diesem Dokument beschrieben. Dieses Kontrollkästchen ist standardmäßig deaktiviert. Aktivieren Sie dieses Kontrollkästchen, damit der Compiler keine Warnungen oder Fehler ausgibt.
Diese Einstellung entspricht der /nowarn Compileroption.
Alle Warnungen als Fehler behandeln
Gibt an, wie Warnungen behandelt werden. Standardmäßig ist dieses Kontrollkästchen deaktiviert, sodass alle Warnbenachrichtigungen auf Warnungfestgelegt bleiben. Aktivieren Sie dieses Kontrollkästchen, um alle Warnbenachrichtigungen in Fehler-zu ändern.
Diese Option ist nur verfügbar, wenn Alle Warnungen deaktivieren, deaktiviert ist.
XML-Dokumentationsdatei generieren
Gibt an, ob Dokumentationsinformationen generiert werden sollen. Dieses Kontrollkästchen ist standardmäßig aktiviert und weist den Compiler an, Dokumentationsinformationen zu generieren und in eine XML-Datei einzuschließen. Deaktivieren Sie dieses Kontrollkästchen, um den Compiler anzuweisen, keine Dokumentation zu erstellen.
Diese Einstellung entspricht der Compileroption /doc.
Registrieren für COM-Interoperabilitäts-
Gibt an, ob ihre verwaltete Anwendung ein COM-Objekt (einen COM-aufrufbaren Wrapper) verfügbar macht, der es einem COM-Objekt ermöglicht, mit der Anwendung zu interagieren.
Standardmäßig ist dieses Kontrollkästchen deaktiviert, das angibt, dass die Anwendung keine COM-Interoperabilität zulässt. Aktivieren Sie dieses Kontrollkästchen, um die COM-Interoperabilität zuzulassen.
Diese Option ist für Windows-Anwendungs- oder Konsolenanwendungsprojekte nicht verfügbar.
Buildereignisse
Klicken Sie auf diese Schaltfläche, um auf das Dialogfeld Buildereignisse zuzugreifen. Verwenden Sie dieses Dialogfeld, um Vorbuild- und Postbuildkonfigurationsanweisungen für das Projekt anzugeben. Dieses Dialogfeld gilt nur für Visual Basic-Projekte. Weitere Informationen finden Sie unter Dialogfeld "Buildereignisse" (Visual Basic).
erweiterten Kompilierungsoptionen
Klicken Sie auf diese Schaltfläche, um auf das Dialogfeld AdvancedCompiler Settings zuzugreifen. Verwenden Sie das Dialogfeld AdvancedCompiler-Einstellungen, um die erweiterten Buildkonfigurationseigenschaften eines Projekts anzugeben. Dieses Dialogfeld gilt nur für Visual Basic-Projekte. Weitere Informationen finden Sie unter Dialogfeld für erweiterte Compilereinstellungen (Visual Basic).