Partager via


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.

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

Autorisations

L'autorisation suivante peut être nécessaire :

Autorisation

Description

EnvironmentPermission

Contrôle la possibilité d'accéder à la variable d'environnement PATH. Énumération associée : Read.

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