WindowsFormsApplicationBase.StartupNextInstance Evento

Referencia

Definición

Espacio de nombres:: Microsoft.VisualBasic.ApplicationServices

Ensamblado:: Microsoft.VisualBasic.dll

Ensamblado:: Microsoft.VisualBasic.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Se produce cuando se intenta iniciar una aplicación de instancia única y la aplicación ya está activa.

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 de evento

StartupNextInstanceEventHandler

Ejemplos

En este ejemplo se usa el e parámetro del controlador de StartupNextInstance eventos para examinar los argumentos de la línea de comandos de la aplicación. Si se encuentra un argumento que comienza por /input=, se muestra el resto de ese argumento.

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 Editor de código para los eventos de la aplicación. Para acceder a esta ventana, siga las instrucciones de la sección Comentarios de este tema. Para obtener más información, consulte Application Page, Project Designer (Visual Basic).

Comentarios

Una aplicación de instancia única genera el StartupNextInstance evento cuando se intenta reiniciar la aplicación cuando ya está activa. Cuando una aplicación de instancia única se inicia por primera vez, genera el Startup evento . Para obtener más información, vea Startup.

Este evento forma parte del modelo de aplicación de Visual Basic. Para obtener más información, vea Información general sobre el modelo de aplicación de Visual Basic.

Este evento se genera en el subproceso principal de la aplicación con los demás eventos de interfaz de usuario. Esto permite al controlador de eventos acceder directamente a la interfaz de usuario de la aplicación. Sin embargo, si la aplicación está ocupada controlando otro evento de interfaz de usuario cuando se genera este evento, este evento no se puede procesar hasta que el otro controlador de eventos finalice o llame al DoEvents método .

Nota

El StartupNextInstance evento solo se genera en aplicaciones de instancia única. Para habilitar el comportamiento de instancia única para la aplicación, debe activar la casilla Make single instance application (Crear aplicación de instancia única ) en el Diseñador de proyectos.


Para crear una instancia única de aplicación
1. Con un proyecto seleccionado en el Explorador de soluciones, haga clic en Propiedades en el menú Proyecto . 2. Haz clic en la pestaña Aplicación. 3. Active la casilla Make single instance application (Crear aplicación de instancia única ).

Debe usar la CommandLine propiedad del e parámetro para acceder a los argumentos de los intentos posteriores de iniciar una aplicación de instancia única. La CommandLineArgs propiedad proporciona los argumentos usados para iniciar la primera instancia de una aplicación de instancia única.

El código del StartupNextInstance controlador de eventos se almacena en el archivo ApplicationEvents.vb, que está oculto de forma predeterminada.


Para acceder a la ventana editor de código para eventos de aplicación
1. Con un proyecto seleccionado en el Explorador de soluciones, haga clic en Propiedades en el menú Proyecto . 2. Haz clic en la pestaña Aplicación. 3. Haga clic en el botón Ver eventos de aplicación para abrir el Editor de código. Para obtener más información, consulte Application Page, Project Designer (Visual Basic).

En la tabla siguiente se enumeran ejemplos de tareas que implican el My.Application.StartupNextInstance evento .

En	Vea
Compruebe los argumentos de la línea de comandos de la primera instancia de aplicación.	CommandLineArgs

Disponibilidad por tipo de proyecto

Tipo de proyecto	Disponible
Aplicación de Windows Forms	Sí
Biblioteca de clases	No
Aplicación de consola	No
Biblioteca de controles de Windows Forms	No
Biblioteca de controles web	No
Servicio de Windows	No
Sitio web	No

Se aplica a

Compartir a través de