My.Application.CommandLineArgs 屬性

發行項
08/21/2008

更新：2007 年 11 月

取得內含命令列引數的集合，做為目前應用程式的字串。

' Usage
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Application.CommandLineArgs
' Declaration
Public ReadOnly Property CommandLineArgs As System.Collections.ObjectModel.ReadOnlyCollection(Of String)

傳回值

String 的 ReadOnlyCollection<T>，包含做為目前應用程式之字串的命令列引數。

備註

對於未部署 ClickOnce 的應用程式，My.Application.CommandLineArgs 屬性可以提供對目前應用程式之命令列引數的唯讀存取權。

對於單一執行個體應用程式，My.Application.CommandLineArgs 屬性會傳回應用程式第一個執行個體的命令列引數。若要存取後續嘗試啟動單一執行個體應用程式的引數，您必須處理 My.Application.StartupNextInstance 事件，並檢查 StartupEventArgs 引數的 CommandLine 屬性。

注意事項：
My.Application.CommandLineArgs 屬性只會傳回命令列引數。這與 CommandLine 屬性的行為不同，後者除了傳回引數，還會傳回應用程式名稱。

注意事項：
在部署了 ClickOnce 的應用程式中，可以使用 My.Application.Deployment 物件的 ActivationUri 屬性取得命令列引數。如需詳細資訊，請參閱 My.Application.Deployment 屬性。

工作

下表列出包含 My.Application.CommandLineArgs 屬性的工作範例。

若要	請參閱
檢查應用程式是否以字串 /batch 做為引數而啟動	HOW TO：啟用 Window Form 應用程式的批次模式
檢查後續嘗試啟動單一執行個體應用程式的命令列引數	My.Application.StartupNextInstance 事件

範例

這個範例使用 My.Application.CommandLineArgs 屬性，檢查應用程式的命令列引數。如果找到以 /input= 開頭的引數，則會顯示此引數的其餘部分。

Private Sub ParseCommandLineArgs()
    Dim inputArgument As String = "/input="
    Dim inputName As String = ""

    For Each s As String In My.Application.CommandLineArgs
        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