WindowsFormsApplicationBase.StartupNextInstance Evento

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 

Tipo evento

Esempio

In questo esempio viene usato il e parametro del StartupNextInstance gestore eventi per esaminare gli argomenti della riga di comando dell'applicazione. Se viene trovato un argomento che inizia con /input=, viene visualizzato il resto di tale argomento.

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

È necessario immettere il codice nella finestra Editor di codice per gli eventi dell'applicazione. Per accedere a questa finestra, seguire le istruzioni della sezione Osservazioni di questo argomento. Per altre informazioni, vedere Application Page, Project Designer (Visual Basic).

Commenti

Un'applicazione a istanza singola genera l'evento StartupNextInstance quando si tenta di riavviare l'applicazione quando è già attiva. Quando un'applicazione a istanza singola viene avviata per la prima volta, genera l'evento Startup . Per altre informazioni, vedere Startup.

Questo evento fa parte del modello di applicazione Visual Basic. Per altre informazioni, vedere Panoramica del modello di applicazione Visual Basic.

Questo evento viene generato nel thread principale dell'applicazione con gli altri eventi dell'interfaccia utente. In questo modo il gestore eventi può accedere direttamente all'interfaccia utente dell'applicazione. Tuttavia, se l'applicazione è occupata a gestire un altro evento dell'interfaccia utente quando viene generato questo evento, questo evento non può essere elaborato fino al termine dell'altro gestore eventi o chiama il DoEvents metodo .

È necessario utilizzare la CommandLine proprietà del e parametro per accedere agli argomenti per i tentativi successivi di avviare un'applicazione a istanza singola. La CommandLineArgs proprietà fornisce gli argomenti usati per avviare la prima istanza di un'applicazione a istanza singola.

Il codice per il StartupNextInstance gestore eventi viene archiviato nel file ApplicationEvents.vb, che è nascosto per impostazione predefinita.

Nella tabella seguente sono elencati esempi di attività che coinvolgono l'evento My.Application.StartupNextInstance .

Disponibilità per tipo di progetto

Si applica a

Vedi anche

• Startup
• CommandLineArgs
• StartupEventArgs
• CommandLine
• Oggetti (Visual Basic)
• Application Page, Project Designer (Visual Basic)
• Cenni preliminari sul modello di applicazione Visual Basic