Partilhar via

Evento My.Application.Startup

  • Artigo

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

  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.Startup.

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 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

SecurityPermission

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

Objeto My.Application

Evento My.Application.StartupNextInstance

Propriedade My.Application.CommandLineArgs

Microsoft.VisualBasic.ApplicationServices.StartupEventArgs

WindowsFormsApplicationBase.Startup