WindowsFormsApplicationBase.StartupNextInstance 事件

定义

命名空间:

Microsoft.VisualBasic.ApplicationServices

程序集:

Microsoft.VisualBasic.Forms.dll

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

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

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

注解

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

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

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

注意

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

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

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

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

访问应用程序事件的“代码编辑器”窗口
1. 在解决方案资源管理器中选择项目后，单击“项目”菜单上的“属性”。 2. 单击“应用程序”选项卡。 3. 单击“ 查看应用程序事件 ”按钮以打开代码编辑器。 有关详细信息，请参阅 Application Page, Project Designer (Visual Basic)（应用程序页、项目设计器 (Visual Basic)。

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

功能	查看
检查第一个应用程序实例的命令行参数	CommandLineArgs

可用性（按项目类型）

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

另请参阅

• Startup
• CommandLineArgs
• StartupEventArgs
• CommandLine
• 对象 (Visual Basic)
• “项目设计器”->“应用程序”页 (Visual Basic)
• Visual Basic 应用程序模型概述