WindowsFormsApplicationBase.StartupNextInstance Ereignis

Definition

Namespace:

Microsoft.VisualBasic.ApplicationServices

Assembly:

Microsoft.VisualBasic.Forms.dll

Tritt beim Versuch ein, eine Einzelinstanzanwendung zu starten, die bereits aktiv ist.

public:
 event Microsoft::VisualBasic::ApplicationServices::StartupNextInstanceEventHandler ^ StartupNextInstance;

public event Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler StartupNextInstance;

member this.StartupNextInstance : Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler 

Public Event StartupNextInstance As StartupNextInstanceEventHandler 

Ereignistyp

StartupNextInstanceEventHandler

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 Fenster Code Editor für Anwendungsereignisse eingeben. Um auf dieses Fenster zuzugreifen, befolgen Sie die Anweisungen im Abschnitt Hinweise dieses Themas. Weitere Informationen finden Sie unter Application Page, Project Designer (Visual Basic).

Hinweise

Eine Anwendung mit instance löst das StartupNextInstance Ereignis aus, wenn Sie versuchen, die Anwendung neu zu starten, wenn sie bereits aktiv ist. Wenn eine Single-instance Anwendung 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 Standard Thread 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 mit der Behandlung eines anderen Benutzeroberflächenereignisses beschäftigt ist, wenn dieses Ereignis ausgelöst wird, kann dieses Ereignis erst verarbeitet werden, wenn der andere Ereignishandler die DoEvents -Methode beendet oder aufruft.

Hinweis

Das StartupNextInstance Ereignis wird nur in Anwendungen mit instance ausgelöst. Zum Aktivieren des Single-instance-Verhaltens für Ihre Anwendung müssen Sie das Kontrollkästchen Einzelne instance Anwendung erstellen im Project Designer aktivieren.

So erstellen Sie eine einzelne instance einer Anwendung
1. Wenn ein Projekt in Projektmappen-Explorer ausgewählt ist, klicken Sie im Menü Projekt auf Eigenschaften. 2. Klicken Sie auf die Registerkarte Anwendung. 3. Aktivieren Sie das Kontrollkästchen Einzelne instance Anwendung erstellen.

Sie müssen die CommandLine -Eigenschaft des e Parameters verwenden, um auf die Argumente für nachfolgende Versuche zuzugreifen, eine Single-instance-Anwendung zu starten. Die CommandLineArgs -Eigenschaft stellt die Argumente bereit, die zum Starten der ersten instance einer Single-instance-Anwendung 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 Fenster Code Editor für Anwendungsereignisse zu
1. Wenn ein Projekt in 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 die Code-Editor zu öffnen. Weitere Informationen finden Sie unter Application Page, Project Designer (Visual Basic).

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die das My.Application.StartupNextInstance Ereignis betreffen.

Beschreibung	Siehe
Überprüfen Sie die Befehlszeilenargumente der ersten Anwendung instance	CommandLineArgs

Verfügbarkeit nach Projekttyp

Projekttyp	Verfügbar
Windows Forms-Anwendung	Ja
Klassenbibliothek	Nein
Konsolenanwendung	Nein
Windows Forms-Steuerelementbibliothek	Nein
Websteuerelementbibliothek	Nein
Windows-Dienst	Nein
Website	Nein

Weitere Informationen

• Startup
• CommandLineArgs
• StartupEventArgs
• CommandLine
• Objekte (Visual Basic)
• Seite „Anwendung“, Projekt-Designer (Visual Basic)
• Übersicht über das Visual Basic-Anwendungsmodell