My.Application.Startup (Evento)

Actualización: noviembre 2007

Se produce cuando se inicia la aplicación.

' Usage
Public Sub Me_Startup( _
   ByVal sender As Object, _
   ByVal e As StartupEventArgs _
) Handles Me.Startup
End Sub
' Declaration
Public Event Startup( _
   ByVal sender As Object, _
   ByVal e As StartupEventArgs _
)

Parámetros

• sender
  El Object que provocó el evento.

• e
  Un objeto StartupEventArgs que contiene los argumentos de la línea de comandos de la aplicación.

Comentarios

Una aplicación normal (de instancia no única) provoca el evento Startup cada vez se inicia. Una aplicación de instancia única provoca el evento Startup cuando sólo se inicia si la aplicación aún no está activa; de lo contrario, provoca el evento StartupNextInstance. Para obtener más información, vea My.Application.StartupNextInstance (Evento) y Cómo: Especificar el comportamiento de las instancias para una aplicación (Visual Basic).

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

Puede utilizar la propiedad Cancel del parámetro e para controlar la carga del formulario de inicio de una aplicación. Cuando la propiedad Cancel está establecida en True, el formulario de inicio no se inicia. En ese caso, su código debería llamar a una ruta de acceso del código de inicio alternativa. Por ejemplo, vea Cómo: Habilitar un modo de procesamiento por lotes para aplicaciones de formularios Window Forms.

Puede utilizar la propiedad CommandLine del parámetro e o la My.Application.CommandLineArgs (Propiedad) para tener acceso a los argumentos de la línea de comandos de la aplicación.

El código de este controlador de eventos Startup se almacena en el archivo ApplicationEvents.vb, que está oculto de manera predeterminada.

Para tener acceso a la ventana del Editor de código para los eventos de aplicación

1. Con un proyecto seleccionado en el Explorador de soluciones, en el menú Proyecto haga clic en Propiedades.

2. Haga clic en la ficha Aplicación.

3. Haga clic en el botón Ver eventos de aplicaciones para abrir el Editor de código.

Para obtener más información, vea Cómo: Controlar eventos de aplicaciones (Visual Basic).

Tareas

La tabla siguiente muestra ejemplos de tareas que implican al evento My.Application.Startup.

Ejemplo

Este ejemplo utiliza la propiedad My.Application.SplashScreen y el evento My.Application.Startup para actualizar la pantalla de inicio con información de estado mientras se inicia la aplicación.

Private Sub MyApplication_Startup( _
    ByVal sender As Object, _
    ByVal e As Microsoft.VisualBasic.ApplicationServices.StartupEventArgs _
) Handles Me.Startup
    ' Get the splash screen.
    Dim splash As SplashScreen1 = CType(My.Application.SplashScreen, SplashScreen1)
    ' Display current status information.
    splash.Status = "Current user: " & My.User.Name
End Sub

Este ejemplo requiere que el proyecto tenga una pantalla de inicio denominada SplashScreen1. La pantalla de inicio debe tener una propiedad denominada Status que actualiza su interfaz de usuario.

Debe escribir el código en la ventana del Editor de código para los eventos de aplicaciones. Para tener acceso a esta ventana, siga las instrucciones de la sección Comentarios de este tema. Para obtener más información, vea Cómo: Controlar eventos de aplicaciones (Visual Basic).

Requisitos

Espacio de nombres:Microsoft.VisualBasic.ApplicationServices

Clase:WindowsFormsApplicationBase

**Ensamblado:**Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Permisos

Los permisos siguientes pueden ser necesarios:

Para obtener más información, vea Seguridad de acceso a código y Solicitar permisos.

Vea también

Tareas

Cómo: Habilitar un modo de procesamiento por lotes para aplicaciones de formularios Window Forms

Cómo: Controlar eventos de aplicaciones (Visual Basic)

Cómo: Especificar el comportamiento de las instancias para una aplicación (Visual Basic)

Conceptos

Información general sobre el modelo de aplicaciones de Visual Basic

Referencia

My.Application (Objeto)

My.Application.StartupNextInstance (Evento)

My.Application.CommandLineArgs (Propiedad)

Microsoft.VisualBasic.ApplicationServices.StartupEventArgs

WindowsFormsApplicationBase.Startup