WindowsFormsApplicationBase.StartupNextInstance Ereignis

Referenz

Definition

Namespace:: Microsoft.VisualBasic.ApplicationServices

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

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 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

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 Code-Editor-Fenster 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 Datei ApplicationEvents.vb gespeichert, die standardmäßig ausgeblendet ist.


So greifen Sie auf das Code-Editor-Fenster 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 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 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

Gilt für: