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

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

Возникает при попытке запуска уже активного приложения одного экземпляра.

' Usage
Public Sub Me_StartupNextInstance( _
   ByVal sender As Object, _
   ByVal e As StartupNextInstanceEventArgs _
) Handles Me.StartupNextInstance
End Sub
' Declaration
Public Event StartupNextInstance( _
   ByVal sender As Object, _
   ByVal e As StartupNextInstanceEventArgs _
)

Параметры

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

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

Заметки

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

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

Это событие вызывается для основного потока приложения с другими событиями интерфейса пользователя . Это позволяет обработчику событий получить доступ напрямую к пользовательскому интерфейсу приложения. Однако, если приложение занято обработкой другого события пользовательского интерфейса при возникновении этого события, оно не будет обработано до тех пор, пока другой обработчик события не завершит работу или вызовет Метод My.Application.DoEvents.

Примечание.

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

Чтобы получить доступ к аргументам для последующих попыток запуска одноэкземплярного приложения, следует использовать свойство CommandLine параметра e. Свойство My.Application.CommandLineArgs предоставляет аргументы, используемые для запуска первого экземпляра одноэкземплярного приложения.

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

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

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

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

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

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

Задачи

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

Пример

В этом примере параметр e обработчика событий StartupNextInstance используется для проверки аргументов командной строки приложения. Если найден аргумент, который начинается с /input=, то отображается остальная часть этого аргумента.

Private Sub MyApplication_StartupNextInstance( _
    ByVal sender As Object, _
    ByVal e As Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventArgs _
) Handles Me.StartupNextInstance
    Dim inputArgument As String = "/input="
    Dim inputName As String = ""

    For Each s As String In e.CommandLine
        If s.ToLower.StartsWith(inputArgument) Then
            inputName = s.Remove(0, inputArgument.Length)
        End If
    Next

    If inputName = "" Then
        MsgBox("No input name")
    Else
        MsgBox("Input name: " & inputName)
    End If
End Sub

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

Требования

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

Класс:WindowsFormsApplicationBase

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

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

Разрешения

Разрешения не требуются.

См. также

Задачи

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

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

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

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

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

Ссылки

Объект My.Application

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

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

StartupEventArgs

CommandLine

WindowsFormsApplicationBase.StartupNextInstance