Teilen über


WindowsFormsApplicationBase.StartupNextInstance Ereignis

Definition

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 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 zu diesem Thema. Weitere Informationen finden Sie unter Application Page, Project Designer (Visual Basic).

Hinweise

Eine Einzelinstanzanwendung 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 damit beschäftigt ist, ein anderes Benutzeroberflächenereignis zu behandeln, 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 Einzelinstanzanwendungen ausgelöst. Um das Einzelinstanzverhalten für Ihre Anwendung zu aktivieren, müssen Sie das Kontrollkästchen Einzelinstanzanwendung erstellen im Projekt-Designer aktivieren.

So machen Sie eine Einzelne Instanz einer Anwendung
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. Aktivieren Sie das Kontrollkästchen Einzelinstanzanwendung erstellen .

Sie müssen die CommandLine -Eigenschaft des e Parameters verwenden, um auf die Argumente für nachfolgende Versuche zuzugreifen, eine Einzelinstanzanwendung zu starten. 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 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 der Befehlszeilenargumente der ersten Anwendungsinstanz 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

Gilt für:

Weitere Informationen