Partilhar via


Propriedade My.Application.CommandLineArgs

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

Permissões

A permissão a seguir pode ser necessária:

Permissão

Descrição

EnvironmentPermission

Controla a capacidade para acessar o variável de ambiente PATH.Enumeração associada: Read.

Para obter mais informações, consulte Segurança de Acesso de código e Solicitando permissões.

Consulte também

Referência

Objeto My.Application

ReadOnlyCollection<T>

ConsoleApplicationBase.CommandLineArgs

Evento My.Application.StartupNextInstance

StartupEventArgs

CommandLine