WindowsFormsApplicationBase.StartupNextInstance 事件

  • 参考

定义

命名空间:
Microsoft.VisualBasic.ApplicationServices
程序集:
Microsoft.VisualBasic.dll
程序集:
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 Custom Event StartupNextInstance As 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 应用程序模型概述。

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

注意

事件 StartupNextInstance 仅在单实例应用程序中引发。 若要为应用程序启用单实例行为，必须在 Project Designer中检查“使单实例应用程序检查”框。
使应用程序成为单个实例
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 服务 否
网站 否

适用于

另请参阅