Interaction.Shell(String, AppWinStyle, Boolean, Int32) Método

public static int Shell(string Pathname, Microsoft.VisualBasic.AppWinStyle Style = Microsoft.VisualBasic.AppWinStyle.MinimizedFocus, bool Wait = false, int Timeout = -1);

public static int Shell(string PathName, Microsoft.VisualBasic.AppWinStyle Style = Microsoft.VisualBasic.AppWinStyle.MinimizedFocus, bool Wait = false, int Timeout = -1);

static member Shell : string * Microsoft.VisualBasic.AppWinStyle * bool * int -> int

static member Shell : string * Microsoft.VisualBasic.AppWinStyle * bool * int -> int

Public Function Shell (Pathname As String, Optional Style As AppWinStyle = Microsoft.VisualBasic.AppWinStyle.MinimizedFocus, Optional Wait As Boolean = false, Optional Timeout As Integer = -1) As Integer

Public Function Shell (PathName As String, Optional Style As AppWinStyle = Microsoft.VisualBasic.AppWinStyle.MinimizedFocus, Optional Wait As Boolean = false, Optional Timeout As Integer = -1) As Integer

Parámetros

Devoluciones

Entero que contiene el identificador de proceso del programa si todavía se está ejecutando. 0 si el programa ya ha terminado de ejecutarse.

Excepciones

Ejemplos

En el ejemplo siguiente se usa la Shell función para ejecutar una aplicación especificada por el usuario. Al especificar AppWinStyle.NormalFocus como segundo argumento se abre la aplicación en tamaño normal y se le proporciona el foco.

Dim procID As Integer
' Run calculator.
procID = Shell("C:\Windows\system32\calc.exe", AppWinStyle.NormalFocus)
' The preceding path is for Windows XP.
' The Windows 2000 path is C:\WINNT\system32\calc.exe.

Comentarios

El valor devuelto de la Shell función depende de si el programa denominado en PathName sigue ejecutándose cuando Shell se devuelve. Si establece Wait en True y el programa finaliza antes de que expire el tiempo de espera, Shell devuelve cero. Si expira el tiempo de espera, o si se omite Wait o se establece Falseen , Shell devuelve el identificador de proceso del programa. El identificador de proceso es un número único que identifica el programa en ejecución.

Error al iniciar

Si la Shell función no puede iniciar el programa con nombre, se produce un FileNotFoundException error. Esto puede ocurrir, por ejemplo, al intentar ejecutar un programa de 16 bits, como command.com, desde una aplicación mediante System.Windows.Forms. Para una solución alternativa, puede ejecutar un programa de 32 bits que llame al programa de 16 bits deseado. En el caso de command.com, puede ejecutarse cmd.exe como alternativa.

Esperando la finalización

De forma predeterminada, la Shell función ejecuta el programa de forma asincrónica. Esto significa que es posible que un programa iniciado con la Shell función no termine de ejecutarse antes de que se ejecuten las instrucciones siguientes a la Shell función. Si desea esperar a que finalice el programa antes de continuar, establezca en WaitTrue.

Determinar el código de salida

Un proceso puede devolver un código de salida cuando finaliza. Sin embargo, no puede usar Shell para recuperar este código de salida, ya Shell que devuelve cero si espera la terminación y también porque el proceso se ejecuta en un objeto diferente de Shell.

Para recuperar el código de salida de un proceso, debe escribir su propio código para iniciar el proceso y esperar la finalización. En el ejemplo siguiente se muestra cómo iniciar un proceso, esperar a que finalice y recuperar su código de salida.

Dim procID As Integer
Dim newProc As Diagnostics.Process
newProc = Diagnostics.Process.Start("C:\WINDOWS\NOTEPAD.EXE")
procID = newProc.Id
newProc.WaitForExit()
Dim procEC As Integer = -1
If newProc.HasExited Then
    procEC = newProc.ExitCode
End If
MsgBox("Process with ID " & CStr(ProcID) & _
    " terminated with exit code " & CStr(procEC))

Protección de la especificación de archivo

Siempre debe incluir toda la ruta de acceso y la especificación de archivo entre comillas, como se muestra en el ejemplo siguiente.

ID = Shell("""C:\Program Files\display.exe"" -a -q", , True, 100000)

Cada par de comillas dobles adyacentes (" ") dentro del literal de cadena se interpreta como un carácter de comilla doble en la cadena. Por lo tanto, en el ejemplo anterior se presenta la siguiente cadena a la Shell función :

"C:\Program Files\display.exe" -a -q

Si no tiene la ruta de acceso entre comillas, Windows buscaría un archivo denominado Program.exe en el directorio C:\, en lugar de display.exe en el directorio C:\Archivos de programa.

Consulte también

• AppWinStyle
• ArgumentException
• FileNotFoundException
• NullReferenceException
• GetFiles
• AppActivate