WindowsFormsApplicationBase.StartupNextInstance 事件

定义

命名空间:

Microsoft.VisualBasic.ApplicationServices

程序集:

Microsoft.VisualBasic.Forms.dll

Source:

WindowsFormsApplicationBase.vb

尝试启动单实例应用程序且应用程序已处于活动状态时发生。

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 

事件类型

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

必须在应用程序事件的“代码编辑器”窗口中输入代码。 若要访问此窗口，请按照本主题的“备注”部分的说明进行操作。 有关详细信息，请参阅应用程序页、项目设计器（Visual Basic）。

注解

当尝试在应用程序处于活动状态时重启应用程序时，单实例应用程序将引发 StartupNextInstance 该事件。 首次启动单实例应用程序时，会引发 Startup 该事件。 有关详细信息，请参阅 Startup。

此事件是 Visual Basic 应用程序模型的一部分。 有关详细信息，请参阅 Visual Basic 应用程序模型的概述。

此事件与其他用户界面事件一起在应用程序的主线程上引发。 这允许事件处理程序直接访问应用程序的用户界面。 但是，如果在引发此事件时应用程序正忙于处理另一个用户界面事件，则在其他事件处理程序完成或调用 DoEvents 该方法之前，无法处理此事件。

注释

事件 StartupNextInstance 仅在单实例应用程序中引发。 若要为应用程序启用单实例行为，必须在项目设计器中选中 “创建单个实例应用程序 ”复选框。

若要创建应用程序单个实例，请执行以下操作：

1. 在解决方案资源管理器中选择项目后，单击“项目”菜单上的“属性”。
2. 单击 “应用程序 ”选项卡。
3. 选中“ 创建单个实例应用程序 ”复选框。|

必须使用 CommandLine 参数的属性 e 来访问参数，以便后续尝试启动单实例应用程序。 该 CommandLineArgs 属性提供用于启动单实例应用程序第一个实例的参数。

事件处理程序的代码 StartupNextInstance 存储在默认隐藏的ApplicationEvents.vb文件中。

若要访问应用程序事件的“代码编辑器”窗口：|1。 在解决方案资源管理器中选择项目后，单击“项目”菜单上的“属性”。
2.单击 “应用程序 ”选项卡。
3.单击 “查看应用程序事件 ”按钮以打开代码编辑器。

有关详细信息，请参阅 应用程序页、项目设计器（Visual Basic）。|

下表列出了涉及 My.Application.StartupNextInstance 该事件的任务的示例。

到	请参阅
检查第一个应用程序实例的命令行参数	CommandLineArgs

按项目类型提供可用性

项目类型	可用
Windows 窗体应用程序	是的
类库	否
控制台应用程序	否
Windows 窗体控件库	否
Web 控件库	否
Windows 服务	否
网站	否

另请参阅

• Startup
• CommandLineArgs
• StartupEventArgs
• CommandLine
• 对象 （Visual Basic）
• 应用页面，项目设计器（Visual Basic）
• Visual Basic 应用程序模型概述