WindowsFormsApplicationBase.StartupNextInstance WindowsFormsApplicationBase.StartupNextInstance WindowsFormsApplicationBase.StartupNextInstance WindowsFormsApplicationBase.StartupNextInstance Event

Определение

Происходит при попытке запуска приложения, допускающего одновременное выполнение только одной своей копии, при наличии уже активного экземпляра этого приложения.Occurs when attempting to start a single-instance application and the application is already active.

public:
 event Microsoft::VisualBasic::ApplicationServices::StartupNextInstanceEventHandler ^ StartupNextInstance;
public event Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler StartupNextInstance;
member this.StartupNextInstance : Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler 
Public Event StartupNextInstance As StartupNextInstanceEventHandler 

Примеры

В этом примере используется e параметр StartupNextInstance обработчика событий для проверки аргументов командной строки приложения.This example uses the e parameter of the StartupNextInstance event handler to examine the application's command-line arguments. Если найден аргумент, начинающийся с /input=, то отображается остальная часть этого аргумента.If an argument is found that starts with /input=, the rest of that argument is displayed.

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

Необходимо ввести код в окне редактора кода для событий приложения.You must enter the code in the Code Editor window for application events. Чтобы открыть это окно, следуйте инструкциям в разделе "Примечания" этого раздела.To access this window, follow the instructions from this topic's Remarks section. Дополнительные сведения см. в разделе Application Page, Project Designer (Visual Basic).For more information, see Application Page, Project Designer (Visual Basic).

Комментарии

Приложение с одним экземпляром вызывает StartupNextInstance событие при попытке перезапустить приложение, когда оно уже активно.A single-instance application raises the StartupNextInstance event when you attempt to restart the application when it is already active. Когда приложение с одним экземпляром запускается в первый раз, оно вызывает Startup событие.When a single-instance application starts for the first time, it raises the Startup event. Для получения дополнительной информации см. Startup.For more information, see Startup.

Это событие является частью модели приложения Visual Basic.This event is part of the Visual Basic Application model. Дополнительные сведения см. в разделе Общие сведения о модели приложения Visual Basic.For more information, see Overview of the Visual Basic Application Model.

Это событие возникает в основном потоке приложения с другими событиями пользовательского интерфейса.This event is raised on the application's main thread with the other user-interface events. Это позволяет обработчику событий получить доступ непосредственно к пользовательскому интерфейсу приложения.This allows the event handler to access directly the application's user interface. Однако если приложение занято обработкой другого события пользовательского интерфейса при возникновении этого события, это событие не может быть обработано до тех пор, пока другой обработчик DoEvents событий не завершит работу или не вызовет метод.However, if the application is busy handling another user-interface event when this event is raised, this event cannot be processed until the other event handler finishes or calls the DoEvents method.

Примечание

StartupNextInstance Событие возникает только в приложениях с одним экземпляром.The StartupNextInstance event is raised only in single-instance applications. Чтобы включить поведение одного экземпляра для приложения, необходимо установить флажок сделать одно экземплярное приложение в конструкторе проектов.To enable single-instance behavior for your application, you must check the Make single instance application check box in the Project Designer.

Создание отдельного экземпляра приложенияTo make an application single instance
1. Выбрав проект в Обозреватель решений, в меню проект выберите пункт свойства .1. With a project selected in Solution Explorer, click Properties on the Project menu.
2. Перейдите на вкладку Приложение .2. Click the Application tab.
3. Установите флажок сделать одно экземплярное приложение .3. Select the Make single instance application check box.

Чтобы получить доступ к CommandLine аргументам для e последующих попыток запуска приложения с одним экземпляром, необходимо использовать свойство параметра.You must use the CommandLine property of the e parameter to access the arguments for subsequent attempts to start a single-instance application. CommandLineArgs Свойство предоставляет аргументы, используемые для запуска первого экземпляра приложения с одним экземпляром.The CommandLineArgs property provides the arguments used to start the first instance of a single-instance application.

Код для StartupNextInstance обработчика событий хранится в файле ApplicationEvents. vb, который по умолчанию скрыт.The code for the StartupNextInstance event handler is stored in the ApplicationEvents.vb file, which is hidden by default.

Доступ к окну редактора кода для событий приложенияTo access the Code Editor window for application events
1. Выбрав проект в Обозреватель решений, в меню проект выберите пункт свойства .1. With a project selected in Solution Explorer, click Properties on the Project menu.
2. Перейдите на вкладку Приложение .2. Click the Application tab.
3. Нажмите кнопку Просмотреть события приложения , чтобы открыть редактор кода.3. Click the View Application Events button to open the Code Editor.

Дополнительные сведения см. в разделе Application Page, Project Designer (Visual Basic).For more information, see Application Page, Project Designer (Visual Basic).

В следующей таблице приведены примеры задач, My.Application.StartupNextInstance включающих событие.The following table lists examples of tasks involving the My.Application.StartupNextInstance event.

КомуTo См.See
Проверьте аргументы командной строки первого экземпляра приложения.Check the command-line arguments of the first application instance CommandLineArgs

Доступность по типу проектаAvailability by Project Type

Тип проектаProject type ДоступноAvailable
Приложение Windows FormsWindows Forms Application ДаYes
Библиотека классовClass Library НетNo
Консольное приложениеConsole Application НетNo
Библиотека элементов управления Windows FormsWindows Forms Control Library НетNo
Библиотека веб-элементов управленияWeb Control Library НетNo
Служба WindowsWindows Service НетNo
Веб-сайтWeb Site НетNo

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

Дополнительно