My.Application.CommandLineArgs-Eigenschaft

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

Berechtigungen

Die folgende Berechtigung ist möglicherweise erforderlich:

Berechtigung

Beschreibung

EnvironmentPermission

Steuert die Fähigkeit, auf die PATH-Umgebungsvariable zuzugreifen. Zugeordnete Enumeration: Read.

Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.

Siehe auch

Referenz

My.Application-Objekt

ReadOnlyCollection<T>

ConsoleApplicationBase.CommandLineArgs

My.Application.StartupNextInstance-Ereignis

StartupEventArgs

CommandLine