WindowsFormsApplicationBase.StartupNextInstance Gebeurtenis

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 

Gebeurtenistype

Voorbeelden

In dit voorbeeld wordt de e parameter van de gebeurtenis-handler gebruikt om de StartupNextInstance opdrachtregelargumenten van de toepassing te onderzoeken. Als er een argument wordt gevonden dat begint met /input=, wordt de rest van dat argument weergegeven.

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

U moet de code invoeren in het venster Code-editor voor toepassingsevenementen. Volg de instructies in de sectie Opmerkingen van dit onderwerp voor toegang tot dit venster. Zie Application Page, Project Designer (Visual Basic) voor meer informatie.

Opmerkingen

Een toepassing met één exemplaar genereert de StartupNextInstance gebeurtenis wanneer u probeert de toepassing opnieuw op te starten wanneer deze al actief is. Wanneer een toepassing met één exemplaar voor het eerst wordt gestart, wordt de Startup gebeurtenis gegenereerd. Zie Startup voor meer informatie.

Deze gebeurtenis maakt deel uit van het Visual Basic Toepassingsmodel. Zie Overview van het Visual Basic-toepassingsmodel voor meer informatie.

Deze gebeurtenis wordt gegenereerd op de hoofdthread van de toepassing met de andere gebruikersinterfacegebeurtenissen. Hierdoor heeft de gebeurtenishandler rechtstreeks toegang tot de gebruikersinterface van de toepassing. Als de toepassing echter bezig is met het verwerken van een andere gebruikersinterfacegebeurtenis wanneer deze gebeurtenis wordt gegenereerd, kan deze gebeurtenis pas worden verwerkt als de andere gebeurtenis-handler is voltooid of de DoEvents methode aanroept.

Eén exemplaar van een toepassing maken:

1. Klik met een project geselecteerd in Solution Explorer op Properties in het menu Project.
2. Klik op het tabblad Toepassing.
3. Schakel het selectievakje Eén exemplaartoepassing maken in.|

U moet de CommandLine eigenschap van de e parameter gebruiken om toegang te krijgen tot de argumenten voor volgende pogingen om een toepassing met één exemplaar te starten. De CommandLineArgs eigenschap bevat de argumenten die worden gebruikt om het eerste exemplaar van een toepassing met één exemplaar te starten.

De code voor de StartupNextInstance gebeurtenis-handler wordt opgeslagen in het ApplicationEvents.vb-bestand, dat standaard verborgen is.

Het venster Code-editor openen voor toepassingsevenementen: |1. Klik met een project geselecteerd in Solution Explorer op Properties in het menu Project.
2. Klik op het tabblad Toepassing .
3. Klik op de knop Toepassingsevenementen weergeven om de Code-editor te openen.

Zie Application Page, Project Designer (Visual Basic) voor meer informatie.

De volgende tabel bevat voorbeelden van taken met betrekking tot de My.Application.StartupNextInstance gebeurtenis.

Beschikbaarheid per projecttype

Zie ook

• Startup
• CommandLineArgs
• StartupEventArgs
• CommandLine
• Objects (Visual Basic)
• Applicatiepagina, Project Designer (Visual Basic)
• Overzicht van het Visual Basic-toepassingsmodel