WindowsFormsApplicationBase.Startup Evento

Definición

Se produce cuando se inicia la aplicación.Occurs when the application starts.

public:
 event Microsoft::VisualBasic::ApplicationServices::StartupEventHandler ^ Startup;
public event Microsoft.VisualBasic.ApplicationServices.StartupEventHandler Startup;
member this.Startup : Microsoft.VisualBasic.ApplicationServices.StartupEventHandler 
Public Custom Event Startup As StartupEventHandler 
Public Event Startup As StartupEventHandler 

Ejemplos

En este ejemplo se usa la propiedad My.Application.SplashScreen y el evento My.Application.Startup para actualizar la pantalla de presentación con información de estado a medida que se inicia la aplicación.This example uses the My.Application.SplashScreen property and the My.Application.Startup event to update the splash screen with status information as the application starts.

Private Sub MyApplication_Startup(
    sender As Object,
    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 presentación denominada SplashScreen1.This example requires that the project have a splash screen named SplashScreen1. La pantalla de presentación debe tener una propiedad denominada Status que actualice su interfaz de usuario.The splash screen needs to have property named Status that updates its user interface.

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 normal (que no es de instancia única) genera el evento Startup cada vez que se inicia.A normal (non-single-instance) application raises the Startup event every time it starts. Una aplicación de instancia única genera el evento Startup cuando se inicia solo si la aplicación aún no está activa; de lo contrario, genera el evento StartupNextInstance.A single-instance application raises the Startup event when it starts only if the application is not already active; otherwise, it raises the StartupNextInstance event. Para más información, consulte StartupNextInstance.For more information, see StartupNextInstance.

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.

Puede usar la propiedad Cancel del parámetro e para controlar la carga del formulario de inicio de una aplicación.You can use the Cancel property of the e parameter to control the loading of an application's startup form. Cuando la propiedad Cancel está establecida en True, el formulario de inicio no se inicia.When the Cancel property is set to True, the startup form does not start. En ese caso, el código debe llamar a una ruta de acceso del código de inicio alternativa.In that case, your code should call an alternate startup code path.

Puede usar la propiedad CommandLine del parámetro e o la propiedad CommandLineArgs para tener acceso a los argumentos de la línea de comandos de la aplicación.You can use the CommandLine property of the e parameter or the CommandLineArgs property to access the application's command-line arguments.

El código del controlador de eventos Startup se almacena en el archivo ApplicationEvents. VB, que está oculto de forma predeterminada.The code for the Startup 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 aplicación 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).

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: