Свойство My.Application.CommandLineArgs

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращает коллекцию, содержащую аргументы командной строки в виде строк для текущего приложения.

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

Возвращаемое значение

Коллекция ReadOnlyCollection<T> из String содержит аргументы командной строки в виде строк для текущего приложения.

Заметки

Свойство My.Application.CommandLineArgs предоставляет доступ только для чтения к аргументам командной строки для приложений, которые не развернуты с помощью ClickOnce.

Для приложения, допускающего одновременное выполнение только одного своего экземпляра, свойство My.Application.CommandLineArgs возвращает аргументы командной строки для первого экземпляра приложения. Чтобы получить доступ к аргументам для последующих попыток запуска приложения, допускающего одновременное выполнение только одного своего экземпляра, необходимо обработать Cобытие My.Application.StartupNextInstance и проверить свойство CommandLine аргумента StartupEventArgs.

Примечание.
Свойство My.Application.CommandLineArgs возвращает только аргументы командной строки. Оно отличается от свойства CommandLine, которое помимо аргументов возвращает имя приложения.

Примечание.
В приложении, развернутом с помощью ClickOnce, чтобы получить аргументы командной строки, используется свойство ActivationUri объекта My.Application.Deployment. Дополнительные сведения см. в разделе Свойство My.Application.Deployment.

Задачи

В следующей таблице перечислены примеры задач с использованием свойства My.Application.CommandLineArgs.

To	См. разделы
Проверьте, запускается ли приложение со строкой /batch в качестве аргумента	Практическое руководство. Включение пакетного режима для приложений Windows Forms
Проверка аргументов командной строки при попытках последующего запуска приложения, допускающего одновременное выполнение только одного своего экземпляра	Cобытие My.Application.StartupNextInstance

Пример

В этом примере свойство My.Application.CommandLineArgs используется для проверки аргументов командной строки приложения. Если найден аргумент, который начинается с /input=, то отображается остальная часть этого аргумента.

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

Требования

Пространство имен:Microsoft.VisualBasic.ApplicationServices

Класс:ConsoleApplicationBase

**Сборка:**Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)

Доступность по типу проекта

Тип проекта	Доступность
Приложение Windows	Да
Библиотека классов	Нет
Консольное приложение	Да
Библиотека элементов управления Windows	Нет
Библиотека веб-элементов управления	Нет
Служба Windows	Да
Веб-узел	Нет