WindowsFormsApplicationBase.StartupNextInstance Événement

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

public event Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler StartupNextInstance;

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

Public Custom Event StartupNextInstance As StartupNextInstanceEventHandler 

Public Event StartupNextInstance As StartupNextInstanceEventHandler 

Type d'événement

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 .

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.

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

Disponibilité par type de projet

S’applique à

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