WindowsFormsApplicationBase.StartupNextInstance Evento

Definición

Se produce cuando se intenta iniciar una aplicación de instancia única y la aplicación ya está activa.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 

Ejemplos

En este ejemplo se usa el parámetro e del controlador de eventos StartupNextInstance para examinar los argumentos de la línea de comandos de la aplicación.This example uses the e parameter of the StartupNextInstance event handler to examine the application's command-line arguments. Si se encuentra un argumento que empieza por /input=, se muestra el resto de ese argumento.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

Debe escribir el código en la ventana del editor de código para los eventos de aplicación.You must enter the code in the Code Editor window for application events. Para obtener acceso a esta ventana, siga las instrucciones de la sección Comentarios de este tema.To access this window, follow the instructions from this topic's Remarks section. Para obtener más información, consulte Application Page, Project Designer (Visual Basic).For more information, see Application Page, Project Designer (Visual Basic).

Comentarios

Una aplicación de instancia única genera el evento StartupNextInstance cuando intenta reiniciar la aplicación cuando ya está activa.A single-instance application raises the StartupNextInstance event when you attempt to restart the application when it is already active. Cuando se inicia una aplicación de instancia única por primera vez, se genera el evento Startup.When a single-instance application starts for the first time, it raises the Startup event. Para obtener más información, vea Startup.For more information, see Startup.

Este evento forma parte del modelo de aplicación Visual Basic.This event is part of the Visual Basic Application model. Para obtener más información, vea información general sobre el modelo de aplicación Visual Basic.For more information, see Overview of the Visual Basic Application Model.

Este evento se desencadena en el subproceso principal de la aplicación con los otros eventos de la interfaz de usuario.This event is raised on the application's main thread with the other user-interface events. Esto permite que el controlador de eventos acceda directamente a la interfaz de usuario de la aplicación.This allows the event handler to access directly the application's user interface. Sin embargo, si la aplicación está ocupada controlando otro evento de interfaz de usuario cuando se produce este evento, este evento no se puede procesar hasta que el otro controlador de eventos finalice o llame al método DoEvents.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

El evento StartupNextInstance se genera solo en aplicaciones de instancia única.The StartupNextInstance event is raised only in single-instance applications. Para habilitar el comportamiento de una sola instancia en la aplicación, debe activar la casilla crear aplicación de instancia única en el diseñador de proyectos.To enable single-instance behavior for your application, you must check the Make single instance application check box in the Project Designer.

Para crear una aplicación de una sola instanciaTo make an application single instance
1. Con un proyecto seleccionado en Explorador de soluciones, haga clic en propiedades en el menú proyecto .1. With a project selected in Solution Explorer, click Properties on the Project menu.
2. Haga clic en la pestaña Aplicación .2. Click the Application tab.
3. Active la casilla crear aplicación de instancia única .3. Select the Make single instance application check box.

Debe utilizar la propiedad CommandLine del parámetro e para tener acceso a los argumentos de los intentos posteriores para iniciar una aplicación de instancia única.You must use the CommandLine property of the e parameter to access the arguments for subsequent attempts to start a single-instance application. La propiedad CommandLineArgs proporciona los argumentos utilizados para iniciar la primera instancia de una aplicación de una sola instancia.The CommandLineArgs property provides the arguments used to start the first instance of a single-instance application.

El código del controlador de eventos StartupNextInstance se almacena en el archivo ApplicationEvents. VB, que está oculto de forma predeterminada.The code for the StartupNextInstance event handler is stored in the ApplicationEvents.vb file, which is hidden by default.

Para tener acceso a la ventana del editor de código para eventos de aplicaciónTo access the Code Editor window for application events
1. Con un proyecto seleccionado en Explorador de soluciones, haga clic en propiedades en el menú proyecto .1. With a project selected in Solution Explorer, click Properties on the Project menu.
2. Haga clic en la pestaña Aplicación .2. Click the Application tab.
3. Haga clic en el botón Ver eventos de aplicaciones para abrir el Editor de código.3. Click the View Application Events button to open the Code Editor.

Para obtener más información, consulte Application Page, Project Designer (Visual Basic).For more information, see Application Page, Project Designer (Visual Basic).

En la tabla siguiente se muestran ejemplos de tareas que implican el evento My.Application.StartupNextInstance.The following table lists examples of tasks involving the My.Application.StartupNextInstance event.

EnTo VeaSee
Comprobar los argumentos de la línea de comandos de la primera instancia de la aplicaciónCheck the command-line arguments of the first application instance CommandLineArgs

Disponibilidad por tipo de proyectoAvailability by Project Type

Tipo de proyectoProject type DisponibleAvailable
Aplicación de Windows FormsWindows Forms Application Yes
Biblioteca de clasesClass Library NoNo
Aplicación de consolaConsole Application NoNo
Biblioteca de controles de Windows FormsWindows Forms Control Library NoNo
Biblioteca de controles WebWeb Control Library NoNo
Servicio de WindowsWindows Service NoNo
Sitio webWeb Site NoNo

Se aplica a

Consulte también: