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)。

備註

當您嘗試在應用程式已在使用中時重新開機應用程式時， StartupNextInstance 單一實例應用程式就會引發 事件。 第一次啟動單一實例應用程式時，它會引發 Startup 事件。 如需詳細資訊，請參閱Startup。

此事件是 Visual Basic 應用程式模型的一部分。 如需詳細資訊，請參閱 Visual Basic 應用程式模型概觀。

此事件會在應用程式的主執行緒上，與其他使用者介面事件一起引發。 這可讓事件處理常式直接存取應用程式的使用者介面。 不過，如果應用程式在引發此事件時忙於處理另一個使用者介面事件，則除非其他事件處理常式完成或呼叫 DoEvents 方法，否則無法處理此事件。

注意

事件 StartupNextInstance 只會在單一實例應用程式中引發。 若要為您的應用程式啟用單一實例行為，您必須在 Project Designer中核取 [建立單一實例應用程式] 核取方塊。
建立應用程式單一實例
1.在方案總管中選取專案時，按一下 [專案] 功能表上的 [屬性]。
2. 按一下 [應用程式]索引標籤。
3.選取 [建立單一實例應用程式] 核取方塊。

您必須使用 CommandLine 參數的 e 屬性來存取引數，以便後續嘗試啟動單一實例應用程式。 屬性 CommandLineArgs 提供用來啟動單一實例應用程式第一個實例的引數。

事件處理常式的程式 StartupNextInstance 代碼會儲存在預設隱藏的 ApplicationEvents.vb 檔案中。
存取應用程式事件的 [程式碼編輯器] 視窗
1.在方案總管中選取專案時，按一下 [專案] 功能表上的 [屬性]。
2. 按一下 [應用程式]索引標籤。
3.按一下 [ 檢視應用程式事件] 按鈕以開啟程式碼編輯器。

如需詳細資訊，請參閱 Application Page, Project Designer (Visual Basic)。

下表列出涉及 My.Application.StartupNextInstance 事件的工作範例。

收件者 請參閱
檢查第一個應用程式實例的命令列引數 CommandLineArgs

依專案類型的可用性

專案類型 可用
Windows Forms 應用程式 是
類別庫 否
主控台應用程式 否
Windows Form 控制項程式庫 否
Web 控制項程式庫 否
Windows 服務 否
網站 否

適用於

另請參閱