My.Application.CommandLineArgs, propriété

Article
08/21/2008

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.

Pour	Consultez
Vérifier si l'application a démarré avec la chaîne /batch comme argument	Comment : activer un mode batch pour des applications Windows Forms
Vérifier les arguments de ligne de commande pour les tentatives de démarrage ultérieures d'une application à instance unique	My.Application.StartupNextInstance, événement

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

Type de projet	Disponible
Application Windows	Oui
Bibliothèque de classes	Non
Application console	Oui
Bibliothèque de contrôles Windows	Non
Bibliothèque de contrôles Web	Non
Service Windows	Oui
Site Web	Non