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

備註

當您嘗試在應用程式已在使用中時重新啟動應用程式時， 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)。

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

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

依專案類型的可用性

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

另請參閱

• Startup
• CommandLineArgs
• StartupEventArgs
• CommandLine
• 物件 (Visual Basic)
• Application Page, Project Designer (Visual Basic)
• Visual Basic 應用程式模型概觀