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
Con un proyecto seleccionado en el Explorador de soluciones, en el menú Proyecto haga clic en Propiedades.
Haga clic en la ficha Aplicación.
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.
Para |
Vea |
|---|---|
Utilizar los eventos proporcionados por el modelo de aplicaciones de Visual Basic para ejecutar código |
Cómo: Ejecutar código cuando se inicia o se cierra la aplicación |
Compruebe si la aplicación se inició con cadena /batch como un argumento |
Cómo: Habilitar un modo de procesamiento por lotes para aplicaciones de formularios Window Forms |
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
Tipo de proyecto |
Disponible |
|---|---|
Aplicación para Windows |
Sí |
Biblioteca de clases |
No |
Aplicación de consola |
No |
Biblioteca de controles de Windows |
No |
Biblioteca de controles Web |
No |
Servicio de Windows |
No |
Sitio Web |
No |
Permisos
Los permisos siguientes pueden ser necesarios:
Permiso |
Descripción |
|---|---|
Controla la capacidad de agregar un controlador de eventos para este evento. Enumeración asociada: SecurityPermissionFlag.ControlAppDomain. |
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.StartupNextInstance (Evento)
My.Application.CommandLineArgs (Propiedad)