WindowsFormsApplicationBase.StartupNextInstance Evento

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.VisualBasic.ApplicationServices
Assembly:
Microsoft.VisualBasic.dll
Assembly:
Microsoft.VisualBasic.Forms.dll

Si verifica durante il tentativo di avvio di un'applicazione a istanza singola quando l'applicazione è già attiva.

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

StartupNextInstanceEventHandler

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 Codice Editor 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 .

Nota

L'evento StartupNextInstance viene generato solo nelle applicazioni a istanza singola. Per abilitare il comportamento a istanza singola per l'applicazione, è necessario selezionare la casella di controllo Crea applicazione a istanza singola nell'Designer di Project.
Per creare una singola istanza dell'applicazione
1. Con un progetto selezionato in Esplora soluzioni, fare clic su Proprietà dal menu Progetto.
2. Fare clic sulla scheda Applicazione .
3. Selezionare la casella di controllo Crea applicazione a istanza singola .

È 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.
Per accedere alla finestra di Editor del codice per gli eventi dell'applicazione
1. Con un progetto selezionato in Esplora soluzioni, fare clic su Proprietà dal menu Progetto.
2. Fare clic sulla scheda Applicazione .
3. Fare clic sul pulsante Visualizza eventi applicazione per aprire il codice Editor.

Per altre informazioni, vedere Application Page, Project Designer (Visual Basic).

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

A Vedere
Controllare gli argomenti della riga di comando della prima istanza dell'applicazione CommandLineArgs

Disponibilità per tipo di progetto

Tipo di progetto Disponibile
Windows Forms Application Sì
Libreria di classi No
Applicazione console No
Libreria di controllo Windows Form No
Libreria di controlli Web No
Servizio Windows No
Sito Web No

Si applica a

Vedi anche