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
Wählen Sie im Projektmappen-Explorer ein Projekt aus, und klicken Sie im Menü Projekt auf Eigenschaften.
Klicken Sie auf die Registerkarte Anwendung.
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 |
|---|---|
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.StartupNextInstance-Ereignis
My.Application.CommandLineArgs-Eigenschaft