Application Page, Project Designer (Visual Basic)

Legen Sie auf der Seite Anwendung des Projekt-Designers die Anwendungseinstellungen und -eigenschaften eines Projekts fest.

Um auf die Seite Anwendung zuzugreifen, wählen Sie im Projektmappen-Explorer einen Projektknoten (nicht den Knoten Projektmappen aus. Wählen Sie dann in der Menüleiste Projekt>Eigenschaften aus. Wenn der Projekt-Designer angezeigt wird, klicken Sie auf die Registerkarte Anwendung.

Hinweis

Auf Ihrem Computer werden möglicherweise andere Namen oder Speicherorte für die Benutzeroberflächenelemente von Visual Studio angezeigt als die in diesem Artikel. Möglicherweise verwenden Sie eine andere Edition von Visual Studio oder andere Umgebungseinstellungen. Weitere Informationen finden Sie unter Personalisieren der IDE.

Allgemeine Anwendungseinstellungen

Mit den folgenden Optionen können Sie allgemeine Einstellungen für eine Anwendung konfigurieren.

Assemblyname

Gibt den Namen der Ausgabedatei an, in der das Assemblymanifest enthalten ist. Wenn Sie diese Eigenschaft ändern, wird auch die Eigenschaft Ausgabename geändert.

Sie können den Namen der Ausgabedatei auch an einer Eingabeaufforderung mit dem Compilerschalter /out (Visual Basic) angeben.

Informationen zum programmgesteuerten Zugreifen auf diese Eigenschaft finden Sie unter AssemblyName.

Stammnamespace

Legt den Basisnamespace für alle Dateien im Projekt fest. Wenn Sie beispielsweise den Stammnamespace auf Project1 festgelegt haben und eine Class1 außerhalb aller Namespaces im Code vorhanden ist, würde deren Namespace Project1.Class1 lauten. Wäre eine Class2 in einem Namespace Order im Code vorhanden ist, würde deren Namespace Project1.Order.Class2 lauten.

Wenn Sie den Stammnamespace löschen, können Sie die Namespacestruktur Ihres Projekts im Code festlegen.

Hinweis

Wenn Sie das Global-Schlüsselwort in einer Namespaceanweisung verwenden, können Sie einen Namespace außerhalb des Stammnamespaces Ihres Projekts definieren. Wenn Sie den Stammnamespace löschen, wird der Namespace Global der Namespace der obersten Ebene, wodurch die Notwendigkeit entfällt, das Global-Schlüsselwort in einer Namespace-Anweisung zu verwenden. Weitere Informationen finden Sie unter „Global-Schlüsselwort in Namespace-Anweisungen“ unter Namespaces in Visual Basic.

Informationen zum Erstellen von Namespaces im Code finden Sie unter Namespace-Anweisung.

Weitere Informationen zur Stammnamespace-Eigenschaft finden Sie unter /rootnamespace.

Informationen zum programmgesteuerten Zugreifen auf diese Eigenschaft finden Sie unter RootNamespace.

Zielframework (alle Konfigurationen)

Gibt die .NET-Version an, auf die die Anwendung ausgerichtet ist. Diese Option kann unterschiedliche Werte aufweisen, je nachdem, welche Versionen von .NET auf Ihrem Computer installiert sind.

Für .NET Framework-Projekte entspricht der Standardwert dem Zielframework, das Sie beim Erstellen des Projekts angegeben haben.

Hinweis

Die im Dialogfeld Erforderliche Komponenten aufgelisteten Pakete mit erforderlichen Komponenten werden automatisch festgelegt, wenn Sie das Dialogfeld zum ersten Mal öffnen. Wenn im Nachhinein Änderungen am Zielframework des Projekts vorgenommen werden, müssen Sie die erforderlichen Komponenten entsprechend dem neuen Zielframework manuell auswählen.

Weitere Informationen finden Sie unter Übersicht über Frameworkziele.

Anwendungstyp

Gibt den Typ der zu erstellenden Anwendung an. Die Werte unterscheiden sich je nach Projekttyp. Für ein Windows Forms-App-Projekt können Sie zum Beispiel Windows Forms-Anwendung, Klassenbibliothek, Konsolenanwendung, Windows-Dienst oder Websteuerelementbibliothek angeben.

Für ein Webanwendungsprojekt müssen Sie -Klassenbibliothek angeben.

Weitere Informationen zur Eigenschaft Anwendungstyp finden Sie unter /target (Visual Basic). Informationen zum programmgesteuerten Zugreifen auf diese Eigenschaft finden Sie unter OutputType.

Bindungsumleitungen automatisch generieren

Bindungsumleitungen werden zu Ihrem Projekt hinzugefügt, wenn Ihre App oder die zugehörigen Komponenten auf mehrere Versionen derselben Assembly verweisen. Wenn Sie Bindungsumleitungen manuell in der Projektdatei definieren möchten, deaktivieren Sie Bindungsumleitungen automatisch generieren.

Weitere Informationen zur Umleitung finden Sie unter Umleiten von Assemblyversionen.

Startformular/Startobjekt/Start-URI

Gibt das Startformular oder den Einstiegspunkt der Anwendung an.

Wenn Anwendungsframework aktivieren ausgewählt ist (Standard), heißt diese Liste Startformular und zeigt nur Formulare an, da das Anwendungsframework ausschließlich Startformulare und keine Objekte unterstützt.

Wenn es sich bei dem Projekt um eine WPF-Browseranwendung handelt, heißt diese Liste Start-URI, und der Standardwert lautet Page1.xaml. Die Mithilfe der Liste Start-URI können Sie die Benutzeroberflächenressource (ein XAML-Element) angeben, die beim Start der Anwendung angezeigt wird. Weitere Informationen finden Sie unter StartupUri.

Wenn Anwendungsframework aktivieren deaktiviert ist, wird diese Liste zu Startobjekt und zeigt sowohl Formulare als auch Klassen oder Module mit einer Sub Main an.

Startobjekt definiert den Einstiegspunkt, der aufgerufen werden soll, wenn die Anwendung geladen wird. Dieser wird üblicherweise entweder auf das Hauptformular der Anwendung oder auf die Sub Main-Prozedur festgelegt, die beim Start der Anwendung ausgeführt werden soll. Da Klassenbibliotheken über keinen Einstiegspunkt verfügen, ist ihre einzige Option für diese Eigenschaft (Keine) . Weitere Informationen finden Sie unter /main. Informationen zum programmgesteuerten Zugriff auf diese Eigenschaft finden Sie unter StartupObject.

Symbol

Legt die ICO-Datei fest, die als Programmsymbol verwendet werden soll. Wählen Sie <Durchsuchen...> aus, um nach einer vorhandenen Grafik zu suchen. Weitere Informationen finden Sie unter /win32icon (oder /win32icon (C#-Compileroptionen)). Informationen zum programmgesteuerten Zugriff auf diese Eigenschaft finden Sie unter ApplicationIcon.

Assemblyinformationen

Klicken Sie auf diese Schaltfläche, um das DialogfeldAssemblyinformationen anzuzeigen.

Anwendungsframework aktivieren

Gibt an, ob ein Projekt das Anwendungsframework verwendet. Die Einstellung dieser Option wirkt sich auf die unter Startformular/Startobjekt verfügbaren Optionen aus.

Ist dieses Kontrollkästchen aktiviert, verwendet die Anwendung die Standard-Sub Main. Durch Aktivieren dieses Kontrollkästchens werden die Features im Abschnitt Eigenschaften des Windows-Anwendungsframeworks aktiviert, und Sie müssen ein Startformular auswählen.

Ist dieses Kontrollkästchen deaktiviert, verwendet die Anwendung die benutzerdefinierte Sub Main, die Sie unter Startformular angegeben haben. In diesem Fall können Sie entweder ein Startobjekt (eine benutzerdefinierte Sub Main in einer Methode oder Klasse) oder ein Formular angeben. Außerdem sind die Optionen im Abschnitt Eigenschaften des Windows-Anwendungsframeworks nicht mehr verfügbar.

Windows-Einstellungen anzeigen

Klicken Sie auf diese Schaltfläche, um die Datei app.manifest zu erstellen und zu öffnen. Visual Studio verwendet diese Datei zum Generieren von Manifestdaten für die Anwendung. Legen Sie dann die von der Benutzerkontensteuerung angeforderte Ausführungsebene fest, indem Sie das <requestedExecutionLevel>-Tag in app.manifest wie folgt ändern:

<requestedExecutionLevel level="asInvoker" />

ClickOnce funktioniert mit der Ebene asInvoker oder im virtualisierten Modus (keine Generierung von Manifesten). Um den virtualisierten Modus anzugeben, entfernen Sie das gesamte Tag aus „app.manifest“.

Eigenschaften des Windows-Anwendungsframeworks

Die folgenden Einstellungen sind im Abschnitt Eigenschaften des Windows-Anwendungsframeworks verfügbar. Diese Optionen sind nur verfügbar, wenn das Kontrollkästchen Anwendungsframework aktivieren aktiviert ist.

Tipp

Im folgenden Abschnitt werden die Einstellungen Eigenschaften des Windows-Anwendungsframeworks beschrieben, die für Windows Presentation Foundation-Apps (WPF) spezifisch sind.

Aktivieren von visuellen Windows-Stilen

Aktiviert oder deaktiviert die visuellen Windows-Stile, auch als Windows-Designs bezeichnet. Die visuellen Windows-Stile aktivieren z. B. Steuerelemente mit gerundeten Ecken und dynamischen Farben. Die Option ist standardmäßig aktiviert.

Einzelinstanzanwendung erstellen

Aktivieren Sie dieses Kontrollkästchen, um zu verhindern, dass Benutzer mehrere Instanzen der Anwendung ausführen. Standardmäßig ist dieses Kontrollkästchen deaktiviert, sodass mehrere Instanzen der Anwendung ausgeführt werden können. Weitere Informationen finden Sie beim StartupNextInstance-Ereignis.

My.Settings beim Herunterfahren speichern

Aktivieren Sie dieses Kontrollkästchen, um anzugeben, dass die My.Settings-Einstellungen der Anwendung beim Herunterfahren des Computers gespeichert werden. Das Kontrollkästchen ist standardmäßig aktiviert. Wird diese Option deaktiviert, können Anwendungseinstellungen manuell durch Aufrufen von My.Settings.Save gespeichert werden.

Authentifizierungsmodus

Wählen Sie Windows (Standard) aus, um festzulegen, dass der aktuell angemeldete Benutzer über die Windows-Authentifizierung identifiziert wird. Sie können diese Informationen mit dem My.User-Objekt zur Laufzeit abrufen. Wählen Sie Anwendungsdefiniert, wenn Sie anstelle der standardmäßigen Windows-Authentifizierungsmethoden eigenen Code zum Authentifizieren der Benutzern bereitstellen.

Modus für das Herunterfahren

Wählen Sie Beim Schließen des Startformulars (Standard) aus, um festzulegen, dass die Anwendung beendet wird, wenn das als Startformular festgelegte Formular geschlossen wird, auch wenn andere Formulare geöffnet sind. Wählen Sie Beim Schließen des letzten Formulars aus, um festzulegen, dass die Anwendung beendet wird, wenn das letzte Formular geschlossen oder die My.Application.Exit- bzw. die End-Anweisung explizit aufgerufen wird.

Wählen Sie Beim expliziten Herunterfahren aus, um festzulegen, dass die Anwendung bei einem expliziten Aufruf von Shutdown beendet wird.

Wählen Sie Beim Schließen des letzten Fensters aus, um festzulegen, dass die Anwendung beendet wird, wenn das letzte Fenster geschlossen oder Shutdown explizit aufgerufen wird. Dies ist die Standardeinstellung.

Wählen Sie Beim Schließen des Hauptfensters aus, um festzulegen, dass die Anwendung beendet wird, wenn das Hauptfenster geschlossen oder Shutdown explizit aufgerufen wird.

Begrüßungsbildschirm

Wählen Sie das Formular aus, das Sie als Begrüßungsbildschirm verwenden möchten. Sie müssen zuvor mithilfe eines Formulars oder einer Vorlage einen Begrüßungsbildschirm erstellt haben. Der Standardwert lautet (Keine) .

Anwendungsereignisse anzeigen

Klicken Sie auf diese Schaltfläche, um eine Ereigniscodedatei anzuzeigen, in die Sie Ereignisse für die Anwendungsframeworkereignisse Startup, Shutdown, UnhandledException, StartupNextInstance und NetworkAvailabilityChanged schreiben können. Sie können auch bestimmte Anwendungsframeworkmethoden überschreiben. Beispielsweise können Sie das Anzeigeverhalten des Begrüßungsbildschirms ändern, indem Sie OnInitialize überschreiben.

Eigenschaften des Windows-Anwendungsframeworks für Windows Presentation Foundation-Apps (WPF)

Die folgenden Einstellungen sind im Abschnitt Eigenschaften des Windows-Anwendungsframeworks verfügbar, wenn das Projekt eine Windows Presentation Foundation-App (WPF) ist. Diese Optionen sind nur verfügbar, wenn das Kontrollkästchen Anwendungsframework aktivieren aktiviert ist. Die in dieser Tabelle aufgeführten Optionen sind nur für WPF oder WPF-Browseranwendungen verfügbar. Sie sind nicht für WPF-Benutzersteuerelement- oder benutzerdefinierte Steuerelementbibliotheken verfügbar.

Modus für das Herunterfahren

Diese Eigenschaft gilt nur für Windows Presentation Foundation-Anwendungen (WPF).

Wählen Sie Beim expliziten Herunterfahren aus, um festzulegen, dass die Anwendung bei einem expliziten Aufruf von Shutdown beendet wird.

Wählen Sie Beim Schließen des letzten Fensters aus, um festzulegen, dass die Anwendung beendet wird, wenn das letzte Fenster geschlossen oder Shutdown explizit aufgerufen wird. Dies ist die Standardeinstellung.

Wählen Sie Beim Schließen des Hauptfensters aus, um festzulegen, dass die Anwendung beendet wird, wenn das Hauptfenster geschlossen oder Shutdown explizit aufgerufen wird.

Weitere Informationen über die Verwendung diese Einstellung finden Sie unter Shutdown.

XAML bearbeiten

Durch Klicken auf diese Schaltfläche wird die Anwendungsdefinitionsdatei („Application.xaml“) im XAML-Editor geöffnet. Wenn Sie auf diese Schaltfläche klicken, wird der Anwendungsdefinitionsknoten von Application.xaml geöffnet. Möglicherweise müssen Sie diese Datei bearbeiten, um bestimmte Aufgaben auszuführen, wie z.B. das Definieren von Ressourcen. Wenn keine Anwendungsdefinitionsdatei vorhanden ist, wird sie vom Projekt-Designer erstellt.

Anwendungsereignisse anzeigen

Durch Klicken auf diese Schaltfläche wird die Application-Klassendatei (Application.xaml.vb) in einem Code-Editor geöffnet. Wenn die Datei nicht vorhanden ist, wird sie vom Projekt-Designer mit dem entsprechenden Namen und Namespace erstellt.

Das Objekt Application löst Ereignisse aus, wenn bestimmte Anwendungszustandsänderungen stattfinden (z.B. beim Starten oder Herunterfahren der Anwendung). Eine vollständige Liste der Ereignisse, die diese Klasse verfügbar macht, finden Sie unter Application. Diese Ereignisse werden im Benutzercodeabschnitt der partiellen Application-Klasse verarbeitet.