WindowsFormsApplicationBase.Startup Evento

Definição

Namespace:

Microsoft.VisualBasic.ApplicationServices

Assembly:

Microsoft.VisualBasic.Forms.dll

Ocorre quando o aplicativo é iniciado.

public:
 event Microsoft::VisualBasic::ApplicationServices::StartupEventHandler ^ Startup;

public event Microsoft.VisualBasic.ApplicationServices.StartupEventHandler Startup;

member this.Startup : Microsoft.VisualBasic.ApplicationServices.StartupEventHandler 

Public Event Startup As StartupEventHandler 

Tipo de evento

StartupEventHandler

Exemplos

Este exemplo usa a My.Application.SplashScreen propriedade e o My.Application.Startup evento para atualizar a tela inicial com status informações conforme o aplicativo é iniciado.

Private Sub MyApplication_Startup(
    sender As Object,
    e As Microsoft.VisualBasic.ApplicationServices.StartupEventArgs
) Handles Me.Startup
    ' Get the splash screen.
    Dim splash As SplashScreen1 = CType(My.Application.SplashScreen, SplashScreen1)
    ' Display current status information.
    splash.Status = "Current user: " & My.User.Name
End Sub

Este exemplo exige que o projeto tenha uma tela inicial chamada SplashScreen1. A tela inicial precisa ter uma propriedade chamada Status que atualize sua interface do usuário.

Você deve inserir o código na janela Code Editor para eventos de aplicativo. Para acessar essa janela, siga as instruções da seção Comentários deste tópico. Para obter mais informações, consulte Página de aplicativo, Designer de Projeto (Visual Basic).

Comentários

Um aplicativo normal (não de instância única) gera o Startup evento sempre que ele é iniciado. Um aplicativo de instância única aciona o Startup evento quando ele é iniciado somente se o aplicativo ainda não estiver ativo; caso contrário, ele aciona o StartupNextInstance evento. Para obter mais informações, consulte StartupNextInstance.

Esse evento faz parte do modelo de Aplicativo do Visual Basic. Para obter mais informações, consulte Visão geral do Modelo de Aplicativo do Visual Basic.

Você pode usar a Cancel propriedade do e parâmetro para controlar o carregamento do formulário de inicialização de um aplicativo. Quando a Cancel propriedade é definida como True, o formulário de inicialização não é iniciado. Nesse caso, seu código deve chamar um caminho de código de inicialização alternativo.

Você pode usar a CommandLine propriedade do e parâmetro ou da CommandLineArgs propriedade para acessar os argumentos de linha de comando do aplicativo.

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

Para acessar a janela code Editor para eventos de aplicativo
1. Com um projeto selecionado em Gerenciador de Soluções, clique em Propriedades no menu Projeto. 2. Clique na guia Aplicativo. 3. Clique no botão Exibir Eventos do Aplicativo para abrir a Editor de Código. Para obter mais informações, consulte Página de aplicativo, Designer de Projeto (Visual Basic).

Disponibilidade por tipo de projeto

Tipo de projeto	Disponível
Aplicativo do Windows Forms	Sim
Biblioteca de Classes	Não
Aplicativo do Console	Não
Biblioteca de Controle Windows Forms	Não
Biblioteca de Controles da Web	Não
Serviço do Windows	Não
Site	Não

Confira também

• StartupNextInstance
• CommandLineArgs
• Objetos (Visual Basic)
• Página de Aplicativo, Designer de Projeto (Visual Basic)
• Visão geral do modelo de aplicativo do Visual Basic