Evento My.Application.StartupNextInstance

Ocorre quando há tentativa de iniciar uma aplicação de instância única e a aplicação já está ativa.

' Usage
Public Sub Me_StartupNextInstance( _
   ByVal sender As Object, _
   ByVal e As StartupNextInstanceEventArgs _
) Handles Me.StartupNextInstance
End Sub
' Declaration
Public Event StartupNextInstance( _
   ByVal sender As Object, _
   ByVal e As StartupNextInstanceEventArgs _
)

Parâmetros

• sender
  O Object o que elevou o evento.

• e
  Um objeto StartupEventArgs que contém os argumentos da linha de comando do aplicativo.

Comentários

Um aplicativo single-instância aumenta o StartupNextInstance evento quando você tenta reiniciar o aplicativo quando ele já estiver ativo. Quando um aplicativo single-instância inicia pela primeira vez, ele gera o Startup evento. Para obter mais informações, consulte Evento My.Application.Startup e Como: Especificar a instanciação comportamento para um aplicativo (Visual Basic).

Este evento é parte do modelo de aplicativo Visual Basic.Para obter mais informações, consulte Visão Geral Sobre o Modelo do Aplicativo Visual Basic.

Este evento é gerado no segmento principal do aplicativo com os outros eventos da interface do usuário.Isso permite que o manipulador de eventos acessar diretamente a interface do usuário do aplicativo.No entanto, se o aplicativo estiver ocupado tratando outro evento da interface do usuário quando esse evento é gerado, esse evento não pode ser processado até que o outro manipulador de eventos termine ou chame Método My.Application.DoEvents.

Observação:
O StartupNextInstance evento é gerado somente em aplicativos single-instância. Para ativar o comportamento de uma única instância do aplicativo, você deve fazer o Tornar o aplicativo de instância única a caixa de seleção no projeto Designer.Para obter mais informações, consulte Como: Especificar a instanciação comportamento para um aplicativo (Visual Basic).

Você deve usar o CommandLine propriedade das e parâmetro para acessar os argumentos subseqüentes tentativas de iniciar um aplicativo single-instância. The Propriedade My.Application.CommandLineArgs fornece os argumentos usados para iniciar a primeira instância de um aplicativo single-instance.

O código para o manipulador StartupNextInstance de eventos é armazenado no arquivo ApplicationEvents.vb, que está oculta por padrão.

Para acessar a janela Editor de Códigos para eventos de aplicativo

1. Com um projeto selecionado no Solution Explorer, clique em Propriedades no menu Projeto.

2. Clique na guia Application.

3. Clique no botão View Application Events para abrir o Editor de Código.

   Para obter mais informações, consulte Como: Manipular eventos de aplicativo (Visual Basic).

Tarefas

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

Para	Consulte
Utilize os eventos fornecidos pelo modelo de aplicativo Visual Basic para executar o código	Como: Executar código quando o aplicativo inicia ou termina
Verifique os argumentos de linha de comando da primeira instância de aplicativo	Propriedade My.Application.CommandLineArgs

Exemplo

Este exemplo usa o e parâmetro das StartupNextInstance manipulador de eventos para examinar os argumentos de linha de comando do aplicativo. Se for encontrado um argumento que começa com /input=, o resto desse argumento é exibido.

Private Sub MyApplication_StartupNextInstance( _
    ByVal sender As Object, _
    ByVal 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

Você deve inserir o código na janela Editor de Códigos para eventos do aplicativo.Para acessar essa janela, siga as instruções da seção Comentários deste tópico.Para obter mais informações, consulte Como: Manipular eventos de aplicativo (Visual Basic).

Requisitos

Namespace:Microsoft.VisualBasic.ApplicationServices

Classe:WindowsFormsApplicationBase

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Não
Aplicativo de Console	Não
Biblioteca de Controle do Windows	Não
Biblioteca de Controle da Web	Não
Serviço do Windows	Não
Site	Não

Permissões

Não requer nenhuma permissão.

Consulte também

Tarefas

Como: Manipular eventos de aplicativo (Visual Basic)

Como: Especificar a instanciação comportamento para um aplicativo (Visual Basic)

Como: Especificar a instanciação comportamento para um aplicativo (Visual Basic)

Conceitos

Visão Geral Sobre o Modelo do Aplicativo Visual Basic

Referência

Objeto My.Application

Evento My.Application.Startup

Propriedade My.Application.CommandLineArgs

StartupEventArgs

CommandLine

WindowsFormsApplicationBase.StartupNextInstance