Propriedade My.Application.CommandLineArgs

Artigo
08/25/2010

Obtém uma coleção contendo os argumentos de linha de comando como cadeias de caracteres para a aplicação atual.

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

Valor de retorno

Valor de propriedade

Um ReadOnlyCollection<T> de String, que contém os argumentos de linha de comando como sequências de caracteres para o aplicativo atual.

Comentários

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

Para um aplicativo de instância única, a propriedade My.Application.CommandLineArgs 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 tratar a Evento My.Application.StartupNextInstance e examinar a propriedade CommandLine do argumento StartupEventArgs.

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

Observação:
Em um aplicativo ClickOnce implantado, usar o ActivationUri propriedade das My.Application.Deployment objeto para obter os argumentos de linha de comando. Para obter mais informações, consulte Propriedade My.aplicativo.implantação.

Tarefas

A tabela seguinte lista exemplos de tarefas envolvendo a propriedade My.Application.CommandLineArgs.

Para	Consulte
Verifique se o aplicativo foi iniciado com a sequência de caracteres /batch como um argumento	Como: Ativar um modo em lotes para aplicativos do Janelas Forms
Verificar os argumentos de linha de comando de tentativas subsequentes para iniciar um aplicativo de instância única	Evento My.Application.StartupNextInstance

Exemplo

Este exemplo usa a propriedade My.Application.CommandLineArgs para examinar os argumentos de linha de comando do aplicativo.Se for encontrado um argumento que começa com /input=, o resto desse argumento é 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

Requisitos

Namespace:Microsoft.VisualBasic.ApplicationServices

Classe:ConsoleApplicationBase

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Não
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Não
Biblioteca de Controle da Web	Não
Serviço do Windows	Sim
Site	Não