Compartilhar via


ConsoleApplicationBase.CommandLineArgs Propriedade

Definição

Obtém uma coleção que contém os argumentos de linha de comando como cadeias de caracteres para o aplicativo atual.

public:
 property System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ CommandLineArgs { System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ get(); };
public System.Collections.ObjectModel.ReadOnlyCollection<string> CommandLineArgs { get; }
member this.CommandLineArgs : System.Collections.ObjectModel.ReadOnlyCollection<string>
Public ReadOnly Property CommandLineArgs As ReadOnlyCollection(Of String)

Valor da propriedade

Um ReadOnlyCollection<T> de String, contendo os argumentos de linha de comando como cadeias de caracteres para o aplicativo atual.

Exemplos

Este exemplo usa a My.Application.CommandLineArgs propriedade para examinar os argumentos de linha de comando do aplicativo. Se for encontrado um argumento que comece com /input=, o restante desse argumento será exibido.

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

Comentários

A My.Application.CommandLineArgs propriedade fornece acesso somente leitura aos argumentos de linha de comando do aplicativo atual para aplicativos que não são implantados no ClickOnce.

Para um aplicativo de instância única, a My.Application.CommandLineArgs propriedade retorna os argumentos de linha de comando para a primeira instância de um aplicativo. Para acessar os argumentos para tentativas subsequentes de iniciar um aplicativo de instância única, você deve manipular o StartupNextInstance evento e examinar a CommandLine propriedade do StartupEventArgs argumento.

Observação

A My.Application.CommandLineArgs propriedade retorna apenas os argumentos de linha de comando. Isso é diferente do comportamento da CommandLine propriedade, que retorna o nome do aplicativo além dos argumentos.

Observação

Em um aplicativo implantado pelo ClickOnce, use a ActivationUri propriedade do My.Application.Deployment objeto para obter os argumentos de linha de comando. Para obter mais informações, consulte Deployment.

A tabela a seguir lista exemplos de tarefas que envolvem a My.Application.CommandLineArgs propriedade.

Para Veja
Verifique os argumentos de linha de comando das tentativas subsequentes de iniciar um aplicativo de instância única StartupNextInstance

Disponibilidade por tipo de projeto

Tipo de projeto Disponível
Aplicativo do Windows Sim
Biblioteca de Classes No
Aplicativo de console Sim
Biblioteca de Controle do Windows No
Biblioteca de Controle da Web No
Serviço do Windows Sim
Site No

Aplica-se a

Confira também