My.Application.CommandLineArgs (Propiedad)

Artículo
08/23/2008

Actualización: noviembre 2007

Obtiene una colección que contiene los argumentos de la línea de comandos como cadenas para la aplicación actual.

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

Una colección ReadOnlyCollection<T> de String que contiene los argumentos de la línea de comandos como cadenas para la aplicación actual.

Comentarios

La propiedad My.Application.CommandLineArgs proporciona acceso de sólo lectura a los argumentos de línea de comandos de la aplicación actual en las aplicaciones que no se implementan con ClickOnce.

En una aplicación de instancia única, la propiedad My.Application.CommandLineArgs devuelve los argumentos de línea de comandos de la primera instancia de una aplicación. Para tener acceso a los argumentos de intentos posteriores de iniciar una aplicación de instancia única, debe controlar My.Application.StartupNextInstance (Evento) y examinar la propiedad CommandLine del argumento StartupEventArgs.

Nota:
La propiedad My.Application.CommandLineArgs devuelve sólo los argumentos de línea de comandos. Esto es diferente del comportamiento de la propiedad CommandLine, que devuelve el nombre de aplicación además de los argumentos.

Nota:
En una aplicación que se implementa con ClickOnce, utilice la propiedad ActivationUri del objeto My.Application.Deployment para obtener los argumentos de la línea de comandos. Para obtener más información, vea My.Application.Deployment (Propiedad).

Tareas

La tabla siguiente muestra una lista de ejemplos de tareas en las que está implicada la propiedad My.Application.CommandLineArgs.

Para	Vea
Comprobar si la aplicación se ha iniciado con la cadena /batch como un argumento	Cómo: Habilitar un modo de procesamiento por lotes para aplicaciones de formularios Window Forms
Comprobar los argumentos de línea de comandos de intentos siguientes de iniciar una aplicación de instancia única	My.Application.StartupNextInstance (Evento)

Ejemplo

En este ejemplo se utiliza la propiedad My.Application.CommandLineArgs para examinar los argumentos de línea de comandos de la aplicación. Si se encuentra un argumento que comienza con /input=, se muestra el resto de dicho argumento.

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

Espacio de nombres:Microsoft.VisualBasic.ApplicationServices

Clase:ConsoleApplicationBase

**Ensamblado:**Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Tipo de proyecto	Disponible
Aplicación para Windows	Sí
Biblioteca de clases	No
Aplicación de consola	Sí
Biblioteca de controles de Windows	No
Biblioteca de controles Web	No
Servicio de Windows	Sí
Sitio Web	No