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 que contém 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 começa 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 pelo 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 Consulte
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 Não
Aplicativo do Console Sim
Biblioteca de Controle do Windows Não
Biblioteca de Controles da Web Não
Serviço do Windows Sim
Site Não

Aplica-se a

Confira também