Freigeben über


My.Application.Startup-Ereignis

Aktualisiert: November 2007

Tritt ein, wenn die Anwendung gestartet wird.

' Usage
Public Sub Me_Startup( _
   ByVal sender As Object, _
   ByVal e As StartupEventArgs _
) Handles Me.Startup
End Sub
' Declaration
Public Event Startup( _
   ByVal sender As Object, _
   ByVal e As StartupEventArgs _
)

Parameter

  • sender
    Das Object, das das Ereignis ausgelöst hat.

  • e
    Ein StartupEventArgs-Objekt, das die Befehlszeilenargumente der Anwendung enthält.

Hinweise

Eine normale (keine Einzelinstanzanwendung) Anwendung löst das Startup-Ereignis immer aus, wenn sie gestartet wird. Eine Einzelinstanzanwendung löst das Startup-Ereignis beim Starten der Anwendung nur aus, wenn sie nicht bereits aktiv ist. Andernfalls löst sie das StartupNextInstance-Ereignis aus. Weitere Informationen finden Sie unter My.Application.StartupNextInstance-Ereignis und unter Gewusst wie: Angeben des Instanziierungsverhaltens für eine Anwendung (Visual Basic).

Dieses Ereignis ist Bestandteil des Visual Basic-Anwendungsmodells. Weitere Informationen finden Sie unter Übersicht über das Visual Basic-Anwendungsmodell.

Mit der Cancel-Eigenschaft des e-Parameters können Sie das Laden des Startformulars einer Anwendung steuern. Wenn die Cancel-Eigenschaft auf True festgelegt ist, wird das Startformular nicht gestartet. In diesem Fall sollte der Code einen alternativen Codepfad für den Start aufrufen. Ein Beispiel finden Sie unter Gewusst wie: Aktivieren des Batchmodus für Windows Forms-Anwendungen.

Mit der CommandLine-Eigenschaft des e-Parameters oder mit der My.Application.CommandLineArgs-Eigenschaft können Sie auf die Befehlszeilenargumente der Anwendung zugreifen.

Der Code für den Startup-Ereignishandler wird in der Datei ApplicationEvents.vb gespeichert, die standardmäßig ausgeblendet ist.

So öffnen Sie das Code-Editor-Fenster für Anwendungsereignisse

  1. Wählen Sie im Projektmappen-Explorer ein Projekt aus, und klicken Sie im Menü Projekt auf Eigenschaften.

  2. Klicken Sie auf die Registerkarte Anwendung.

  3. Klicken Sie auf die Schaltfläche Anwendungsereignisse anzeigen, um den Code-Editor zu öffnen.

Weitere Informationen finden Sie unter Gewusst wie: Behandeln von Anwendungsereignissen (Visual Basic).

Aufgaben

In der folgenden Tabelle werden Beispiele für Aufgaben mit dem My.Application.Startup-Ereignis aufgeführt.

Vorgang

Thema

Verwenden der vom Visual Basic-Anwendungsmodell bereitgestellten Ereignisse zum Ausführen von Code

Gewusst wie: Ausführen von Code beim Starten oder Beenden einer Anwendung

Überprüfen, ob die Anwendung mit der Zeichenfolge /batch als Argument gestartet wurde

Gewusst wie: Aktivieren des Batchmodus für Windows Forms-Anwendungen

Beispiel

In diesem Beispiel werden die My.Application.SplashScreen-Eigenschaft und das My.Application.Startup-Ereignis verwendet, um den Begrüßungsbildschirm beim Starten der Anwendung mit Statusinformationen zu aktualisieren.

Private Sub MyApplication_Startup( _
    ByVal sender As Object, _
    ByVal e As Microsoft.VisualBasic.ApplicationServices.StartupEventArgs _
) Handles Me.Startup
    ' Get the splash screen.
    Dim splash As SplashScreen1 = CType(My.Application.SplashScreen, SplashScreen1)
    ' Display current status information.
    splash.Status = "Current user: " & My.User.Name
End Sub

Dieses Beispiel erfordert, dass das Projekt einen Begrüßungsbildschirm mit dem Namen SplashScreen1 aufweist. Der Begrüßungsbildschirm muss über die Eigenschaft Status verfügen, die die Benutzeroberfläche aktualisiert.

Sie müssen den Code im Code-Editor-Fenster für Anwendungsereignisse eingeben. Um dieses Fenster zu öffnen, befolgen Sie die Anweisungen im Abschnitt Hinweise dieses Themas. Weitere Informationen finden Sie unter Gewusst wie: Behandeln von Anwendungsereignissen (Visual Basic).

Anforderungen

Namespace:Microsoft.VisualBasic.ApplicationServices

Klasse:WindowsFormsApplicationBase

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Verfügbarkeit nach Projekttyp

Projekttyp

Verfügbar

Windows-Anwendung

Ja

Klassenbibliothek

Nein

Konsolenanwendung

Nein

Windows-Steuerelementbibliothek

Nein

Web-Steuerelementbibliothek

Nein

Windows-Dienst

Nein

Website

Nein

Berechtigungen

Die folgenden Berechtigungen sind möglicherweise erforderlich:

Berechtigung

Beschreibung

SecurityPermission

Steuert die Fähigkeit, einen Ereignishandler für dieses Ereignis hinzuzufügen. Zugeordnete Enumeration: SecurityPermissionFlag.ControlAppDomain.

Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.

Siehe auch

Aufgaben

Gewusst wie: Aktivieren des Batchmodus für Windows Forms-Anwendungen

Gewusst wie: Behandeln von Anwendungsereignissen (Visual Basic)

Gewusst wie: Angeben des Instanziierungsverhaltens für eine Anwendung (Visual Basic)

Konzepte

Übersicht über das Visual Basic-Anwendungsmodell

Referenz

My.Application-Objekt

My.Application.StartupNextInstance-Ereignis

My.Application.CommandLineArgs-Eigenschaft

Microsoft.VisualBasic.ApplicationServices.StartupEventArgs

WindowsFormsApplicationBase.Startup