WindowsFormsApplicationBase.StartupNextInstance WindowsFormsApplicationBase.StartupNextInstance WindowsFormsApplicationBase.StartupNextInstance WindowsFormsApplicationBase.StartupNextInstance Event

Definizione

Si verifica quando si tenta di avviare un'applicazione a istanza singola e l'applicazione è già attiva.Occurs when attempting to start a single-instance application and the application is already active.

public:
 event Microsoft::VisualBasic::ApplicationServices::StartupNextInstanceEventHandler ^ StartupNextInstance;
public event Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler StartupNextInstance;
member this.StartupNextInstance : Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler 
Public Event StartupNextInstance As StartupNextInstanceEventHandler 

Esempi

Questo esempio Usa la e parametro del StartupNextInstance gestore eventi per esaminare gli argomenti della riga di comando dell'applicazione.This example uses the e parameter of the StartupNextInstance event handler to examine the application's command-line arguments. Se viene rilevato un argomento che inizia con /input=, viene visualizzata la parte restante dell'argomento.If an argument is found that starts with /input=, the rest of that argument is displayed.

Private Sub MyApplication_StartupNextInstance( 
    ByVal sender As Object, 
    ByVal 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 dell'Editor di codice per gli eventi dell'applicazione.You must enter the code in the Code Editor window for application events. Per accedere a questa finestra, seguire le istruzioni dalla sezione Osservazioni di questo argomento.To access this window, follow the instructions from this topic's Remarks section. Per altre informazioni, vedere Pagina Applicazione, Creazione progetti (Visual Basic).For more information, see Application Page, Project Designer (Visual Basic).

Commenti

Genera un'applicazione a istanza singola di StartupNextInstance evento quando si tenta di riavviare l'applicazione quando è già attiva.A single-instance application raises the StartupNextInstance event when you attempt to restart the application when it is already active. Quando un'applicazione a istanza singola viene avviato per la prima volta, genera il Startup evento.When a single-instance application starts for the first time, it raises the Startup event. Per altre informazioni, vedere Startup.For more information, see Startup.

Questo evento fa parte del modello di applicazione Visual Basic.This event is part of the Visual Basic Application model. Per altre informazioni, vedere Panoramica del modello di applicazione Visual Basic.For more information, see Overview of the Visual Basic Application Model.

Questo evento viene generato sul thread principale dell'applicazione con gli altri eventi di interfaccia utente.This event is raised on the application's main thread with the other user-interface events. In questo modo il gestore eventi accedere direttamente all'interfaccia utente dell'applicazione.This allows the event handler to access directly the application's user interface. Tuttavia, se l'applicazione è occupato a gestire un altro evento di interfaccia utente quando viene generato questo evento, questo evento non può essere elaborato fino a quando l'altro gestore eventi viene completato o chiama il DoEvents (metodo).However, if the application is busy handling another user-interface event when this event is raised, this event cannot be processed until the other event handler finishes or calls the DoEvents method.

Nota

Il StartupNextInstance evento viene generato solo in applicazioni a istanza singola.The StartupNextInstance event is raised only in single-instance applications. Per abilitare il comportamento di istanza singola per l'applicazione, è necessario controllare la Rendi a istanza singola casella di controllo in Progettazione progetti.To enable single-instance behavior for your application, you must check the Make single instance application check box in the Project Designer.

Per rendere un'applicazione a istanza singolaTo make an application single instance
1. Con un progetto selezionato in Esplora soluzioni, fare clic su delle proprietà sul progetto menu.1. With a project selected in Solution Explorer, click Properties on the Project menu.
2. Fare clic sulla scheda Applicazione .2. Click the Application tab.
3. Selezionare il Rendi a istanza singola casella di controllo.3. Select the Make single instance application check box.

È necessario usare il CommandLine proprietà del e parametro per accedere agli argomenti nei successivi tentativi di avviare un'applicazione a istanza singola.You must use the CommandLine property of the e parameter to access the arguments for subsequent attempts to start a single-instance application. Il CommandLineArgs proprietà fornisce gli argomenti utilizzati per avviare la prima istanza di un'applicazione a istanza singola.The CommandLineArgs property provides the arguments used to start the first instance of a single-instance application.

Il codice per il StartupNextInstance gestore dell'evento viene archiviato nel file ApplicationEvents. vb, che è nascosta per impostazione predefinita.The code for the StartupNextInstance event handler is stored in the ApplicationEvents.vb file, which is hidden by default.

Per accedere alla finestra Editor di codice per gli eventi dell'applicazioneTo access the Code Editor window for application events
1. Con un progetto selezionato in Esplora soluzioni, fare clic su delle proprietà sul progetto menu.1. With a project selected in Solution Explorer, click Properties on the Project menu.
2. Fare clic sulla scheda Applicazione .2. Click the Application tab.
3. Fare clic sul pulsante Visualizza eventi applicazione per aprire l'editor di codice.3. Click the View Application Events button to open the Code Editor.

Per altre informazioni, vedere Pagina Applicazione, Creazione progetti (Visual Basic).For more information, see Application Page, Project Designer (Visual Basic).

La tabella seguente elenca alcuni esempi di attività che implicano il My.Application.StartupNextInstance evento.The following table lists examples of tasks involving the My.Application.StartupNextInstance event.

ATo VedereSee
Controllare gli argomenti della riga di comando della prima istanza dell'applicazioneCheck the command-line arguments of the first application instance CommandLineArgs

Disponibilità dal tipo di progettoAvailability by Project Type

Tipo di progettoProject type DisponibileAvailable
Windows Forms ApplicationWindows Forms Application YesYes
Libreria di classiClass Library NoNo
Applicazione consoleConsole Application NoNo
Libreria di controllo Windows FormWindows Forms Control Library NoNo
Libreria di controlli WebWeb Control Library NoNo
Servizio WindowsWindows Service NoNo
Sito WebWeb Site NoNo

Si applica a

Vedi anche