WindowsFormsApplicationBase.StartupNextInstance Evento

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 

Tipo de Evento

Exemplos

Este exemplo utiliza o e parâmetro do StartupNextInstance gestor de eventos para examinar os argumentos da linha de comandos da aplicação. Se for encontrado um argumento que começa por /input=, o resto desse argumento é apresentado.

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

Deve introduzir o código na janela do Editor de Código para os eventos da aplicação. Para aceder a esta janela, siga as instruções da secção de Comentários deste tópico. Para obter mais informações, consulte Página de aplicativo, Project Designer (Visual Basic).

Observações

Uma aplicação de instância única gera o StartupNextInstance evento quando tenta reiniciar a aplicação estando já ativa. Quando uma aplicação de instância única inicia pela primeira vez, ela levanta o Startup evento. Para obter mais informações, veja Startup.

Este evento faz parte do modelo de aplicação Visual Basic. Para mais informações, consulte Visão Geral do Modelo de Aplicação Visual Basic.

Este evento é levantado no fio principal da aplicação juntamente com os outros eventos da interface de utilizador. Isto permite que o gestor de eventos aceda diretamente à interface de utilizador da aplicação. No entanto, se a aplicação estiver ocupada a tratar outro evento da interface de utilizador quando este evento é levantado, este evento não pode ser processado até que o outro gestor de eventos termine ou chame o DoEvents método.

Para tornar uma aplicação uma instância única:

1. Com uma project selecionada em Explorador de Soluções, clique em Properties no menu Project.
2. Clique no separador Aplicação.
3. Selecione a opção Criar aplicação de instância única .|

Deve usar a CommandLine propriedade do e parâmetro para aceder aos argumentos para tentativas subsequentes de iniciar uma aplicação de instância única. A CommandLineArgs propriedade fornece os argumentos usados para iniciar a primeira instância de uma aplicação de instância única.

O código do StartupNextInstance gestor de eventos é armazenado no ficheiro ApplicationEvents.vb, que está oculto por defeito.

Para aceder à janela do Editor de Código para eventos de aplicação: |1. Com uma project selecionada em Explorador de Soluções, clique em Properties no menu Project.
2. Clique na guia Aplicativo .
3. Clique no botão Ver Eventos da Aplicação para abrir o Editor de Código.

Para mais informações, consulte Página de Candidatura, Project Designer (Visual Basic).|

A tabela seguinte lista exemplos de tarefas envolvendo o My.Application.StartupNextInstance evento.

Disponibilidade por tipo de projeto

Ver também

• Startup
• CommandLineArgs
• StartupEventArgs
• CommandLine
• Objects (Visual Basic)
• Página da Aplicação, Project Designer (Visual Basic)
• Visão geral do modelo de aplicativo Visual Basic