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 gestionnaire d’événements StartupNextInstance pour examiner les arguments de ligne de commande de l’application. Si un argument qui commence par /input=, 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 Code Rédacteur 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 mono-instance démarre pour la première fois, elle déclenche l’événementStartup. 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 main 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’une instance unique pour votre application, vous devez case activée la zone Créer un case activée d’application instance unique dans le Designer Projet.

Pour rendre une application unique instance
1. Avec un projet sélectionné dans Explorateur de solutions, cliquez sur Propriétés dans le menu Projet. 2. Cliquez sur l’onglet Application. 3. Sélectionnez la zone Créer une case activée d’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 Code Rédacteur pour les événements d’application
1. Avec un projet sélectionné dans 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 le code Rédacteur. 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érifiez les arguments de ligne de commande de la première application instance	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