Partilhar via


WindowsFormsApplicationBase.Startup Evento

Definição

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 Custom Event Startup As StartupEventHandler 
Public Event Startup As StartupEventHandler 

Tipo de evento

Exemplos

Este exemplo usa a My.Application.SplashScreen propriedade e o My.Application.Startup evento para atualizar a tela inicial com informações de status 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 requer 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 Editor de Código 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) aciona 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 Truecomo , 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 do Startup manipulador de eventos é armazenado no arquivo ApplicationEvents.vb, que está oculto por padrão.

Para acessar a janela editor de código para eventos de aplicativo
1. Com um projeto selecionado no 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 o Editor de Códigos.

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

Aplica-se a

Confira também