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

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

Paramètres

Retours

Entier contenant l’ID du processus du programme s’il est toujours en cours d’exécution. 0 si le programme a déjà terminé l’exécution.

Exceptions

Exemples

L’exemple suivant utilise la Shell fonction pour exécuter une application spécifiée par l’utilisateur. AppWinStyle.NormalFocus La spécification comme deuxième argument ouvre l’application dans la taille normale et lui donne le focus.

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.

Remarques

La valeur de retour de la Shell fonction dépend si le programme nommé dans est toujours en PathName cours d’exécution lors Shell des retours. Si vous définissez Wait sur True et que le programme se termine avant l’expiration du délai d’expiration, Shell retourne zéro. Si le délai d’expiration expire, ou si vous l’omettez Wait ou le définissez sur False, Shell retourne l’ID de processus du programme. L’ID de processus est un numéro unique qui identifie le programme en cours d’exécution.

Échec du démarrage

Si la Shell fonction ne peut pas démarrer le programme nommé, une FileNotFoundException erreur se produit. Cela peut se produire, par exemple, lorsque vous tentez d’exécuter un programme 16 bits, tel que command.com, à partir d’une application à l’aide System.Windows.Formsde . Pour une solution de contournement, vous pouvez exécuter un programme 32 bits qui appelle le programme 16 bits souhaité. Dans le cas de command.com, vous pouvez exécuter cmd.exe en tant qu’alternative.

En attente d’achèvement

Par défaut, la Shell fonction exécute le programme de manière asynchrone. Cela signifie qu’un programme démarré avec la Shell fonction peut ne pas se terminer avant l’exécution des instructions qui suivent l’exécution de la Shell fonction. Si vous souhaitez attendre que le programme se termine avant de continuer, définissez sur WaitTrue.

Détermination du code de sortie

Un processus peut retourner un code de sortie lorsqu’il se termine. Toutefois, vous ne pouvez pas utiliser Shell pour récupérer ce code de sortie, car Shell retourne zéro s’il attend l’arrêt, et également parce que le processus s’exécute dans un objet différent de Shell.

Pour récupérer le code de sortie d’un processus, vous devez écrire votre propre code pour lancer le processus et attendre l’arrêt. L’exemple suivant montre comment lancer un processus, attendre qu’il se termine et récupérer son code de sortie.

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

Protection de la spécification de fichier

Vous devez toujours placer l’ensemble de la spécification du chemin d’accès et du fichier entre guillemets, comme le montre l’exemple suivant.

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

Chaque paire de guillemets doubles adjacents (" ") dans le littéral de chaîne est interprétée comme un guillemet double dans la chaîne. Par conséquent, l’exemple précédent présente la chaîne suivante à la Shell fonction :

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

Si le chemin d’accès n’était pas placé entre guillemets, Windows recherche un fichier appelé Program.exe dans le répertoire C :\, plutôt que display.exe dans le répertoire C :\Program Files.

S’applique à

Voir aussi

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