WindowsFormsApplicationBase.StartupNextInstance Événement

Définition

Espace de noms:

Microsoft.VisualBasic.ApplicationServices

Assembly:

Microsoft.VisualBasic.Forms.dll

Se produit lors de la tentative de démarrer une application à instance unique et que l'application est déjà active.

public:
 event Microsoft::VisualBasic::ApplicationServices::StartupNextInstanceEventHandler ^ StartupNextInstance;

public event Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler StartupNextInstance;

member this.StartupNextInstance : Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler 

Public Event StartupNextInstance As StartupNextInstanceEventHandler 

Type d'événement

StartupNextInstanceEventHandler

Exemples

Cet exemple utilise le e paramètre du StartupNextInstance gestionnaire d’événements pour examiner les arguments de ligne de commande de l’application. Si un argument qui commence par /input=est trouvé, le reste de cet argument s’affiche.

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

Vous devez entrer le code dans la fenêtre Éditeur de code pour les événements d’application. Pour accéder à cette fenêtre, suivez les instructions de la section Remarques de cette rubrique. Pour plus d'informations, consultez Application Page, Project Designer (Visual Basic).

Remarques

Une application à instance unique déclenche l’événement StartupNextInstance lorsque vous tentez de redémarrer l’application alors qu’elle est déjà active. Lorsqu’une application à instance unique démarre pour la première fois, elle déclenche l’événement Startup . Pour plus d'informations, consultez Startup.

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.

Cet événement est déclenché sur le thread principal de l’application avec les autres événements d’interface utilisateur. Cela permet au gestionnaire d’événements d’accéder directement à l’interface utilisateur de l’application. Toutefois, si l’application est occupée à gérer un autre événement d’interface utilisateur lorsque cet événement est déclenché, cet événement ne peut pas être traité tant que l’autre gestionnaire d’événements n’a pas terminé ou appelé la DoEvents méthode .

Notes

L’événement StartupNextInstance est déclenché uniquement dans les applications à instance unique. Pour activer le comportement d’instance unique pour votre application, vous devez cocher la case Créer une application à instance unique dans le Concepteur de projets.

Pour créer une seule instance d’application
1. Avec un projet sélectionné dans l’Explorateur de solutions, cliquez sur Propriétés dans le menu Projet . 2. Cliquez sur l’onglet Application. 3. Cochez la case Créer une application à instance unique .

Vous devez utiliser la CommandLine propriété du e paramètre pour accéder aux arguments pour les tentatives suivantes de démarrage d’une application à instance unique. La CommandLineArgs propriété fournit les arguments utilisés pour démarrer la première instance d’une application à instance unique.

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

Pour accéder à la fenêtre Éditeur de code pour les événements d’application
1. Avec un projet sélectionné dans l’Explorateur de solutions, cliquez sur Propriétés dans le menu Projet . 2. Cliquez sur l’onglet Application. 3. Cliquez sur le bouton Afficher les événements d’application pour ouvrir l’éditeur de code. Pour plus d'informations, consultez Application Page, Project Designer (Visual Basic).

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

À	Consultez
Vérifier les arguments de ligne de commande de la première instance d’application	CommandLineArgs

Disponibilité par type de projet

Type de projet	Disponible
Application Windows Forms	Oui
Bibliothèque de classes	Non
Application console	Non
Bibliothèque de contrôles Windows Forms	Non
Bibliothèque de contrôles web	Non
Service Windows	Non
Site web	Non

Voir aussi

• Startup
• CommandLineArgs
• StartupEventArgs
• CommandLine
• Objets (Visual Basic)
• Page Application, Concepteur de projet (Visual Basic)
• Vue d'ensemble du modèle d'application Visual Basic