WindowsFormsApplicationBase.StartupNextInstance 事件

定義

命名空間:

Microsoft.VisualBasic.ApplicationServices

組件:

Microsoft.VisualBasic.Forms.dll

來源:

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 表單應用程式	是的
類別庫	No
主控台應用程式	No
Windows 表單控制函式庫	No
網頁控制函式庫	No
Windows 服務	No
網站	No

另請參閱

• Startup
• CommandLineArgs
• StartupEventArgs
• CommandLine
• 物件（Visual Basic ）
• 應用程式頁面、專案設計工具 （Visual Basic）
• Visual Basic 應用程式模型概觀