Событие My.Application.Startup

Обновлен: Ноябрь 2007

Возникает при запуске приложения.

' 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 _
)

Параметры

• sender
  Объект Object, который вызвал событие.

• e
  Объект StartupEventArgs, содержащий аргументы командной строки приложения.

Заметки

Обычное приложение (допускающее одновременное выполнение не только одной своей копии) выполняет событие Startup каждый раз при его запуске. Приложение, допускающее одновременное выполнение только одной своей копии, вызывает событие Startup при запуске, только если приложение еще не активно, в противном случае оно вызывает событие StartupNextInstance. Дополнительные сведения см. в разделах Cобытие My.Application.StartupNextInstance и Практическое руководство. Задание поведения приложения при запуске его экземпляров (Visual Basic).

Это событие является частью модели приложения Visual Basic. Дополнительные сведения см. в разделе Обзор модели приложения в Visual Basic.

Можно использовать свойство Cancel параметра e для управления загрузкой начальной формы приложения. Если свойству Cancel присвоено значение True, начальная форма не запускается. В этом случае код должен вызывать альтернативный путь кода автозагрузки. Например, смотрите Практическое руководство. Включение пакетного режима для приложений Windows Forms.

Можно использовать свойство CommandLine параметра e или Свойство My.Application.CommandLineArgs для доступа к аргументам командной строки приложения.

Код для обработчика событий Startup хранится в файле ApplicationEvents.vb, которой скрыт по умолчанию.

Для доступа к окну редактора кода для событий приложения

1. Для проекта, выбранного в Обозревателе решений, в меню Проект выберите элемент Свойства.

2. Перейдите на вкладку Приложение.

3. Нажмите кнопку Просмотреть события приложения, чтобы открыть редактор кода.

Дополнительные сведения см. в разделе Практическое руководство. Обработка событий приложения (Visual Basic).

Задачи

Ниже перечислены примеры задач, включающих событие My.Application.Startup.

Пример

В этом примере используется свойство My.Application.SplashScreen и событие My.Application.Startup для обновления экрана-заставки данными о состоянии при запуске приложения.

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

Этот пример требует, чтобы проект имел заставку с именем SplashScreen1. Заставка, которая обновляет его пользовательский интерфейс, должна иметь свойство с именем Status.

Необходимо ввести код в окно редактора кода для событий приложения. Чтобы открыть это окно, следуйте инструкциям из главы "Примечания" в этом разделе. Дополнительные сведения см. в разделе Практическое руководство. Обработка событий приложения (Visual Basic).

Требования

Пространство имен:Microsoft.VisualBasic.ApplicationServices

Класс:WindowsFormsApplicationBase

**Сборка:**Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)

Доступность по типу проекта

Разрешения

Могут потребоваться следующие разрешения.

Дополнительные сведения см. в разделах Управление доступом для кода и Запрос разрешений.

См. также

Задачи

Практическое руководство. Включение пакетного режима для приложений Windows Forms

Практическое руководство. Обработка событий приложения (Visual Basic)

Практическое руководство. Задание поведения приложения при запуске его экземпляров (Visual Basic)

Основные понятия

Обзор модели приложения в Visual Basic

Ссылки

Объект My.Application

Cобытие My.Application.StartupNextInstance

Свойство My.Application.CommandLineArgs

Microsoft.VisualBasic.ApplicationServices.StartupEventArgs

WindowsFormsApplicationBase.Startup