Evento My.Application.Startup
Ocorre quando o aplicativo inicializa.
' Usage
Public Sub Me_Startup( _
ByVal sender As Object, _
ByVal e As StartupEventArgs _
) Handles Me.Startup
End Sub
' Declaration
Public Event Startup( _
ByVal sender As Object, _
ByVal e As StartupEventArgs _
)
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 normal (não única instância) gera o evento Startup sempre que ele for iniciado.Um aplicativo de instância única gera o evento Startup quando ele é iniciado somente se o aplicativo for não estiver ativo; caso contrário, ele gera o evento StartupNextInstance.Para obter mais informações, consulte Evento My.Application.StartupNextInstance 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.
Você pode use a propriedade Cancel do parâmetro e para controlar o carregamento de um aplicativo do formulário de inicialização.Quando a propriedade Cancel é configurada True, a forma de inicialização não é iniciada.Nesse caso, o código deve chamar um caminho de código de inicialização alternativa.Por exemplo, ver Como: Ativar um modo em lotes para aplicativos do Janelas Forms.
Você pode use a propriedade CommandLine do parâmetro e ou o Propriedade My.Application.CommandLineArgs Para acessar argumentos de linha de comando do aplicativo.
O código para o manipulador Startup 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
Com um projeto selecionado no Solution Explorer, clique em Propriedades no menu Projeto.
Clique na guia Application.
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.Startup.
Para |
Consulte |
|---|---|
Utilize os eventos fornecidos pelo modelo de aplicativo Visual Basic para executar o código |
|
Verifique se o aplicativo foi iniciado com a sequência de caracteres /batch como um argumento |
Como: Ativar um modo em lotes para aplicativos do Janelas Forms |
Exemplo
Este exemplo usa a propriedade My.Application.SplashScreen e o evento My.Application.Startup para atualizar o tela inicial com informações de status quando se inicia o aplicativo.
Private Sub MyApplication_Startup( _
ByVal sender As Object, _
ByVal 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
Esse exemplo requer que o projeto ter um tela inicial chamado SplashScreen1.A tela inicial precisa ter propriedade chamada Status que atualiza sua interface de usuário.
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
As seguintes permissões podem ser necessárias:
Permissão |
Descrição |
|---|---|
Controla a capacidade para adicionar um manipulador de eventos para este evento.Enumeração associada: SecurityPermissionFlag.ControlAppDomain. |
Para obter mais informações, consulte Segurança de Acesso de código e Solicitando permissões.
Consulte também
Tarefas
Como: Ativar um modo em lotes para aplicativos do Janelas Forms
Como: Manipular eventos de 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
Evento My.Application.StartupNextInstance
Propriedade My.Application.CommandLineArgs