My.Application.Startup, événement

Mise à jour : novembre 2007

Se produit au démarrage de l'application.

' 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 _
)

Paramètres

• sender
  Objet Object qui a déclenché l'événement.

• e
  Objet StartupEventArgs qui contient les arguments de ligne de commande de l'application.

Notes

Une application (à instance non unique) normale déclenche l'événement Startup à chaque démarrage. Une application à instance unique déclenche l'événement Startup au démarrage uniquement si l'application n'est pas déjà active ; sinon, elle déclenche l'événement StartupNextInstance. Pour plus d'informations, consultez My.Application.StartupNextInstance, événement et Comment : spécifier le comportement d'instanciation pour une application (Visual Basic).

Cet événement fait partie du modèle d'application Visual Basic. Pour plus d'informations, consultez Vue d'ensemble du modèle d'application Visual Basic.

Vous pouvez utiliser la propriété Cancel du paramètre e pour contrôler le chargement du formulaire de démarrage d'une application. Lorsque la propriété Cancel a la valeur True, le formulaire de démarrage ne démarre pas. Dans ce cas, votre code doit appeler un autre chemin d'accès de code de démarrage. Par exemple, consultez Comment : activer un mode batch pour des applications Windows Forms.

Vous pouvez utiliser la propriété CommandLine du paramètre e ou la propriété My.Application.CommandLineArgs pour accéder aux arguments de ligne de commande de l'application.

Le code du gestionnaire d'événements Startup est stocké dans le fichier ApplicationEvents.vb, qui est masqué par défaut.

Pour accéder à la fenêtre de l'éditeur de code pour les événements d'application

1. Un projet étant sélectionné dans l'Explorateur de solutions, cliquez dans le menu Projet sur Propriétés.

2. Cliquez sur l'onglet Application.

3. Cliquez sur le bouton Afficher les événements de l'application pour ouvrir l'éditeur de code.

Pour plus d'informations, consultez Comment : gérer les événements d'application (Visual Basic).

Tâches

Le tableau suivant répertorie des exemples de tâches impliquant l'événement My.Application.Startup.

Exemple

Cet exemple utilise la propriété My.Application.SplashScreen et l'événement My.Application.Startup pour mettre à jour l'écran de démarrage à l'aide des informations d'état au démarrage de l'application.

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

Cet exemple requiert que le projet possède un écran de démarrage nommé SplashScreen1. L'écran de démarrage doit contenir une propriété nommée Status qui met à jour son interface utilisateur.

Vous devez entrer le code dans la fenêtre de l'éditeur de code pour les événements d'application. Pour accéder à cette fenêtre, suivez les instructions contenues dans la section Notes de cette rubrique. Pour plus d'informations, consultez Comment : gérer les événements d'application (Visual Basic).

Configuration requise

Espace de noms :Microsoft.VisualBasic.ApplicationServices

Classe :WindowsFormsApplicationBase

**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Autorisations

Les autorisations suivantes peuvent être nécessaires :

Pour plus d'informations, consultez Sécurité d'accès du code et Demande d'autorisations.

Voir aussi

Tâches

Comment : activer un mode batch pour des applications Windows Forms

Comment : gérer les événements d'application (Visual Basic)

Comment : spécifier le comportement d'instanciation pour une application (Visual Basic)

Concepts

Vue d'ensemble du modèle d'application Visual Basic

Référence

My.Application, objet

My.Application.StartupNextInstance, événement

My.Application.CommandLineArgs, propriété

Microsoft.VisualBasic.ApplicationServices.StartupEventArgs

WindowsFormsApplicationBase.Startup