WindowsFormsApplicationBase.Startup Evento

Definição

Ocorre quando a aplicação começa.

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 utiliza a My.Application.SplashScreen propriedade e o My.Application.Startup evento para atualizar o ecrã inicial com a informação de estado à medida que a aplicação inicia.

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 um ecrã inicial chamado SplashScreen1. O ecrã de abertura precisa de ter uma propriedade nomeada Status que atualiza a interface do utilizador.

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 normal (não de instância única) gera o Startup evento sempre que este inicia. Uma aplicação de instância única levanta o Startup evento quando este inicia apenas se a aplicação não estiver já ativa; caso contrário, gera o StartupNextInstance evento. Para obter mais informações, veja StartupNextInstance.

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.

Pode usar a Cancel propriedade do e parâmetro para controlar o carregamento do formulário de arranque de uma aplicação. Quando a Cancel propriedade é definida para True, o formulário inicial não começa. Nesse caso, o teu código deve chamar um caminho alternativo de código de arranque.

Pode usar a CommandLine propriedade do e parâmetro ou da CommandLineArgs propriedade para aceder aos argumentos da linha de comandos da aplicação.

O código do Startup 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 no separador Aplicação.
  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).|

Disponibilidade por tipo de projeto

Tipo de Projeto Available
Aplicação Windows Forms Sim
Biblioteca de Classes No
Aplicativo de console No
Biblioteca de Controlo Windows Forms No
Biblioteca de controle da Web No
Serviço Windows No
Web site No

Aplica-se a

Ver também