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

Definizione

Si verifica durante il tentativo di avvio di un'applicazione a istanza singola quando 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 il e parametro StartupNextInstance del 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 trovato un argomento che inizia con /input=, viene visualizzato il resto dell'argomento.If an argument is found that starts with /input=, the rest of that argument is displayed.

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

Un'applicazione a istanza singola genera l' 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 avviata per la prima volta, genera Startup l'evento.When a single-instance application starts for the first time, it raises the Startup event. Per ulteriori 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 ulteriori 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 dell'interfaccia utente.This event is raised on the application's main thread with the other user-interface events. Questo consente al gestore eventi di accedere direttamente all'interfaccia utente dell'applicazione.This allows the event handler to access directly the application's user interface. Tuttavia, se l'applicazione è occupata per gestire un altro evento dell'interfaccia utente quando viene generato questo evento, questo evento non può essere elaborato finché l'altro gestore eventi DoEvents non termina o chiama il 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

L' StartupNextInstance evento viene generato solo nelle applicazioni a istanza singola.The StartupNextInstance event is raised only in single-instance applications. Per abilitare il comportamento a istanza singola per l'applicazione, è necessario selezionare la casella di controllo Crea applicazione a istanza singola 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 creare un'applicazione a istanza singolaTo make an application single instance
1. Con un progetto selezionato in Esplora soluzioni, fare clic su Proprietà nel menu progetto .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 la casella di controllo Crea applicazione a istanza singola .3. Select the Make single instance application check box.

È necessario utilizzare la CommandLine proprietà e del parametro per accedere agli argomenti per i successivi tentativi di avvio di 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. La 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 eventi è archiviato nel file ApplicationEvents. vb, che è nascosto 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 dell'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 Proprietà nel menu progetto .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).

Nella tabella seguente sono elencati esempi di attività relative all' 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à per tipo di progettoAvailability by Project Type

Tipo di progettoProject type DisponibileAvailable
Windows Forms ApplicationWindows Forms Application Yes
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