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

Teilen über