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 aún 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 da 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 WaitTrue en 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 en False, 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, cuando se intenta 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.

Espera de 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 que Shell devuelve cero si espera la finalizació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 a 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 llamado Program.exe en el directorio C:\, en lugar de en el directorio C:\Archivos de display.exe programa.

Se aplica a

Consulte también

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