WindowsFormsApplicationBase.StartupNextInstance Событие

public:
 event Microsoft::VisualBasic::ApplicationServices::StartupNextInstanceEventHandler ^ StartupNextInstance;

public event Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler StartupNextInstance;

member this.StartupNextInstance : Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler 

Public Custom Event StartupNextInstance As StartupNextInstanceEventHandler 

Public Event StartupNextInstance As StartupNextInstanceEventHandler 

Тип события

Примеры

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

Private Sub MyApplication_StartupNextInstance(
    sender As Object,
    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

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

Комментарии

Приложение с одним экземпляром вызывает StartupNextInstance событие при попытке перезапустить приложение, когда оно уже активно. Когда приложение с одним экземпляром запускается в первый раз, оно вызывает Startup событие . Для получения дополнительной информации см. Startup.

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

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

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

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

В следующей таблице перечислены примеры задач, связанных с событием My.Application.StartupNextInstance .

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

Применяется к

См. также раздел

• Startup
• CommandLineArgs
• StartupEventArgs
• CommandLine
• Объекты (Visual Basic)
• Страница "Приложение" в конструкторе проектов (Visual Basic)
• Обзор модели приложения в Visual Basic