My.Application.CommandLineArgs-Eigenschaft

Artikel
08/20/2008

Aktualisiert: November 2007

Ruft eine Auflistung ab, die die Befehlszeilenargumente für die aktuelle Anwendung als Zeichenfolgen enthält.

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

Rückgabewert

Eine ReadOnlyCollection<T> vom Typ String, die die Befehlszeilenargumente für die aktuelle Anwendung als Zeichenfolgen enthält.

Hinweise

Die My.Application.CommandLineArgs-Eigenschaft ermöglicht für Anwendungen, die nicht mit ClickOnce bereitgestellt werden, den schreibgeschützten Zugriff auf die Befehlszeilenargumente der aktuellen Anwendung.

Für eine Einzelinstanzanwendung gibt die My.Application.CommandLineArgs-Eigenschaft die Befehlszeilenargumente für die erste Instanz einer Anwendung zurück. Um auf die Argumente für nachfolgende Versuche zum Starten einer Einzelinstanzanwendung zuzugreifen, müssen Sie das My.Application.StartupNextInstance-Ereignis behandeln und die CommandLine-Eigenschaft des StartupEventArgs-Arguments überprüfen.

Hinweis:
Die My.Application.CommandLineArgs-Eigenschaft gibt nur die Befehlszeilenargumente zurück. Dies unterscheidet sich vom Verhalten der CommandLine-Eigenschaft, die zusätzlich zu den Argumenten den Anwendungsnamen zurückgibt.

Hinweis:
Verwenden Sie in einer mit ClickOnce bereitgestellten Anwendung die ActivationUri-Eigenschaft des My.Application.Deployment-Objekts zum Abrufen der Befehlszeilenargumente. Weitere Informationen finden Sie unter My.Application.Deployment-Eigenschaft.

Aufgaben

In der folgenden Tabelle werden Beispiele für Aufgaben mit der My.Application.CommandLineArgs-Eigenschaft aufgeführt.

Zweck	Weitere Informationen finden Sie unter
Überprüfen, ob die Anwendung mit der Zeichenfolge /batch als Argument gestartet wurde	Gewusst wie: Aktivieren des Batchmodus für Windows Forms-Anwendungen
Überprüfen der Befehlszeilenargumente von nachfolgenden Versuchen, eine Einzelinstanzanwendung zu starten.	My.Application.StartupNextInstance-Ereignis

Beispiel

In diesem Beispiel wird die My.Application.CommandLineArgs-Eigenschaft verwendet, um die Befehlszeilenargumente der Anwendung zu überprüfen. Wenn ein Argument gefunden wird, das mit /input= beginnt, wird der Rest dieses Arguments angezeigt.

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

Anforderungen

Namespace:Microsoft.VisualBasic.ApplicationServices

Klasse:ConsoleApplicationBase

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Verfügbarkeit nach Projekttyp

Projekttyp	Verfügbar
Windows-Anwendung	Ja
Klassenbibliothek	Nein
Konsolenanwendung	Ja
Windows-Steuerelementbibliothek	Nein
Web-Steuerelementbibliothek	Nein
Windows-Dienst	Ja
Website	Nein