WindowsFormsApplicationBase.StartupNextInstance Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Tritt auf, wenn versucht wird, eine Einzelinstanzanwendung zu starten, und die Anwendung ist bereits aktiv.
public:
event Microsoft::VisualBasic::ApplicationServices::StartupNextInstanceEventHandler ^ StartupNextInstance;public event Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler StartupNextInstance;member this.StartupNextInstance : Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler Public Custom Event StartupNextInstance As StartupNextInstanceEventHandler Public Event StartupNextInstance As StartupNextInstanceEventHandler Ereignistyp
Beispiele
In diesem Beispiel wird der e Parameter des StartupNextInstance Ereignishandlers verwendet, um die Befehlszeilenargumente der Anwendung zu untersuchen. Wenn ein Argument gefunden wird, das mit /input=beginnt, wird der Rest dieses Arguments angezeigt.
Private Sub MyApplication_StartupNextInstance(
sender As Object,
e As Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventArgs
) Handles Me.StartupNextInstance
Dim inputArgument As String = "/input="
Dim inputName As String = ""
For Each s As String In e.CommandLine
If s.ToLower.StartsWith(inputArgument) Then
inputName = s.Remove(0, inputArgument.Length)
End If
Next
If inputName = "" Then
MsgBox("No input name")
Else
MsgBox("Input name: " & inputName)
End If
End Sub
Sie müssen den Code im Code-Editor-Fenster für Anwendungsereignisse eingeben. Um auf dieses Fenster zuzugreifen, folgen Sie den Anweisungen im Abschnitt "Hinweise" dieses Themas. Weitere Informationen finden Sie auf der Anwendungsseite, Project Designer (Visual Basic).
Hinweise
Eine Instanzanwendung löst das StartupNextInstance Ereignis aus, wenn Sie versuchen, die Anwendung neu zu starten, wenn sie bereits aktiv ist. Wenn eine Einzelinstanzanwendung zum ersten Mal gestartet wird, löst sie das Startup Ereignis aus. Weitere Informationen finden Sie unter Startup.
Dieses Ereignis ist Teil des Visual Basic-Anwendungsmodells. Weitere Informationen finden Sie unter Übersicht über das Visual Basic-Anwendungsmodell.
Dieses Ereignis wird im Hauptthread der Anwendung mit den anderen Benutzeroberflächenereignissen ausgelöst. Dadurch kann der Ereignishandler direkt auf die Benutzeroberfläche der Anwendung zugreifen. Wenn die Anwendung jedoch beschäftigt ist, ein anderes Benutzeroberflächenereignis zu behandeln, wenn dieses Ereignis ausgelöst wird, kann dieses Ereignis erst verarbeitet werden, wenn der DoEvents andere Ereignishandler die Methode beendet oder aufruft.
Hinweis
Das StartupNextInstance Ereignis wird nur in Einzelinstanzanwendungen ausgelöst. Um das Verhalten einer einzelnen Instanz für Ihre Anwendung zu aktivieren, müssen Sie das Kontrollkästchen "Einzelne Instanzanwendung erstellen " im Project Designer aktivieren.
So erstellen Sie eine einzelne Instanz einer Anwendung:
- Wenn ein Projekt im Projektmappen-Explorer ausgewählt ist, klicken Sie im Menü "Projekt" auf "Eigenschaften".
- Klicken Sie auf die Registerkarte "Anwendung ".
- Aktivieren Sie das Kontrollkästchen "Einzelne Instanzanwendung erstellen" .|
Sie müssen die CommandLine Eigenschaft des e Parameters verwenden, um auf die Argumente zuzugreifen, um nachfolgende Versuche zum Starten einer Einzelinstanzanwendung durchzuführen. Die CommandLineArgs Eigenschaft stellt die Argumente bereit, die zum Starten der ersten Instanz einer Einzelinstanzanwendung verwendet werden.
Der Code für den StartupNextInstance Ereignishandler wird in der ApplicationEvents.vb Datei gespeichert, die standardmäßig ausgeblendet ist.
So greifen Sie auf das Code-Editor-Fenster für Anwendungsereignisse zu: |1. Wenn ein Projekt im Projektmappen-Explorer ausgewählt ist, 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 auf der Anwendungsseite, Project Designer (Visual Basic).|
In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die das My.Application.StartupNextInstance Ereignis betreffen.
| To | Siehe |
|---|---|
| Überprüfen der Befehlszeilenargumente der ersten Anwendungsinstanz | CommandLineArgs |
Verfügbarkeit nach Projekttyp
| Projekttyp | Verfügbar |
|---|---|
| Windows Forms-Anwendung | Ja |
| Klassenbibliothek | No |
| Konsolenanwendung | No |
| Windows Forms-Steuerelementbibliothek | No |
| Websteuerelementbibliothek | No |
| Windows-Dienst | No |
| Website | No |
