Interaction.Shell(String, AppWinStyle, Boolean, Int32) Metoda

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

Parametry

Návraty

Celé číslo obsahující ID procesu programu, pokud je stále spuštěné. 0, pokud program již byl dokončen.

Výjimky

Příklady

Následující příklad používá Shell funkci ke spuštění aplikace určené uživatelem. Zadáním AppWinStyle.NormalFocus druhého argumentu se aplikace otevře v normální velikosti a fokus se zobrazí.

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.

Poznámky

Návratová Shell hodnota funkce závisí na tom, jestli program pojmenovaný v PathName aplikaci stále probíhá při Shell návratu. Pokud nastavíte WaitTrue hodnotu a program skončí před vypršením časového limitu, Shell vrátí nulu. Pokud vypršení časového limitu vyprší nebo pokud ho vynecháte Wait nebo nastavíte na Falsehodnotu , Shell vrátí ID procesu programu. ID procesu je jedinečné číslo, které identifikuje spuštěný program.

Nepodařilo se spustit

Shell Pokud funkce nemůže spustit pojmenovaný program, dojde k FileNotFoundException chybě. K tomu může dojít například při pokusu o spuštění 16bitového programu, například command.com, z aplikace používající System.Windows.Forms. Alternativní řešení můžete spustit 32bitový program, který volá požadovaný 16bitový program. V případě command.com, můžete spustit cmd.exe jako alternativu.

Čekání na dokončení

Ve výchozím nastavení Shell funkce program spouští asynchronně. To znamená, že program spuštěný s Shell funkcí nemusí dokončit provádění před provedením příkazů, které následují za Shell funkcí. Pokud chcete počkat na dokončení programu, než budete pokračovat, nastavte na Waithodnotu True .

Určení ukončovacího kódu

Proces může po ukončení vrátit ukončovací kód . Nelze však použít Shell k načtení tohoto ukončovacího kódu, protože Shell vrátí nulu, pokud čeká na ukončení, a také proto, že proces běží v jiném objektu než Shell.

Pokud chcete načíst ukončovací kód z procesu, musíte napsat vlastní kód, který zahájí proces a počká na ukončení. Následující příklad ukazuje, jak zahájit proces, počkat na jeho ukončení a načíst jeho ukončovací kód.

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

Ochrana specifikace souboru

Vždy byste měli uzavřít celou cestu a specifikaci souboru do uvozovek, jak ukazuje následující příklad.

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

Každá dvojice sousedních dvojitých uvozovek (" ") v řetězcovém literálu se interpretuje jako jeden dvojitý uvozovek v řetězci. Předchozí příklad proto funkci představuje následující řetězec Shell :

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

Pokud nemáte cestu uzavřenou v uvozovkách, Windows by hledal soubor s názvem Program.exe v adresáři C:\ místo display.exe v adresáři C:\Program Files.

Viz také

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