My.Application.CommandLineArgs, propriété

Mise à jour : novembre 2007

Obtient une collection qui contient les arguments de ligne de commande sous forme de chaînes pour l'application actuelle.

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

Valeur de retour

ReadOnlyCollection<T> de String, qui contient les arguments de ligne de commande sous forme de chaînes pour l'application actuelle.

Notes

La propriété My.Application.CommandLineArgs fournit un accès en lecture seule aux arguments de ligne de commande de l'application actuelle pour les applications qui ne sont pas déployées par ClickOnce.

Pour une application à instance unique, la propriété My.Application.CommandLineArgs retourne les arguments de ligne de commande pour la première instance d'une application. Pour accéder aux arguments pour les tentatives de démarrage ultérieures d'une application à instance unique, vous devez gérer l'événement My.Application.StartupNextInstance et examiner la propriété CommandLine de l'argument StartupEventArgs.

Remarque :
La propriété My.Application.CommandLineArgs retourne uniquement les arguments de ligne de commande. Elle diffère du comportement de la propriété CommandLine qui retourne le nom de l'application, en plus des arguments.

Remarque :
Dans une application déployée par ClickOnce, utilisez la propriété ActivationUri de l'objet My.Application.Deployment pour obtenir les arguments de ligne de commande. Pour plus d'informations, consultez My.Application.Deployment, propriété.

Tâches

Le tableau suivant répertorie des exemples de tâches impliquant la propriété My.Application.CommandLineArgs.

Exemple

Cet exemple utilise la propriété My.Application.CommandLineArgs pour examiner les arguments de ligne de commande de l'application. Si un argument détecté démarre avec /input=, le reste de cet argument est affiché.

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

Configuration requise

Espace de noms :Microsoft.VisualBasic.ApplicationServices

Classe :ConsoleApplicationBase

**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Autorisations

L'autorisation suivante peut être nécessaire :

Pour plus d'informations, consultez Sécurité d'accès du code et Demande d'autorisations.

Voir aussi

Référence

My.Application, objet

ReadOnlyCollection<T>

ConsoleApplicationBase.CommandLineArgs

My.Application.StartupNextInstance, événement

StartupEventArgs

CommandLine