Interaction.Shell(String, AppWinStyle, Boolean, Int32) Yöntem

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

Parametreler

Döndürülenler

Hala çalışıyorsa programın işlem kimliğini içeren bir tamsayı. 0 program zaten yürütmeyi tamamladıysa.

Özel durumlar

Örnekler

Aşağıdaki örnek, kullanıcı tarafından belirtilen bir uygulamayı çalıştırmak için işlevini kullanır Shell . İkinci bağımsız değişken olarak belirtilmesi AppWinStyle.NormalFocus , uygulamayı normal boyutta açar ve odak verir.

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.

Açıklamalar

İşlevin Shell dönüş değeri, içinde adlı PathName programın döndürdüğünde Shell hala yürütüldüğüne bağlıdır. olarak ayarlarsanız WaitTrue ve program zaman aşımı süresi dolmadan önce biterse sıfır Shell döndürür. Zaman aşımı süresi dolarsa veya değerini atlar Wait veya olarak ayarlarsanızFalseShell, programın işlem kimliğini döndürür. İşlem kimliği, çalışan programı tanımlayan benzersiz bir sayıdır.

Başlatma Hatası

Shell İşlev adlandırılmış programı başlatamazsa bir FileNotFoundException hata oluşur. Bu durum, örneğin kullanarak System.Windows.Formsbir uygulamadan gibi 16 bitlik bir program command.comçalıştırmayı denediğinizde oluşabilir. Geçici bir çözüm için, istenen 16 bit programı çağıran 32 bitlik bir program çalıştırabilirsiniz. durumunda command.comalternatif olarak çalıştırabilirsiniz cmd.exe .

Tamamlanması Bekleniyor

Varsayılan olarak, Shell işlev programı zaman uyumsuz olarak çalıştırır. Bu, işlevle Shell başlatılan bir programın, işlevi izleyen deyimler yürütülmeden önce yürütülmesinin Shell tamamlanmayabileceği anlamına gelir. Devam etmeden önce programın bitmesini beklemek istiyorsanız olarak ayarlayın WaitTrue.

Çıkış Kodunu Belirleme

İşlem sonlandırıldığında çıkış kodu döndürebilir. Ancak, sonlandırmayı beklerse sıfır döndürdüğünden ve ayrıca işlem öğesinden Shellfarklı bir nesnede çalıştığından, bu çıkış kodunu Shell almak için kullanamazsınızShell.

Bir işlemden çıkış kodunu almak için, işlemi başlatmak ve sonlandırmayı beklemek için kendi kodunuzu yazmanız gerekir. Aşağıdaki örnekte bir işlemin nasıl başlatıldığı, sonlandırılıp sonlandırılıp çıkış kodunun alınması beklenmek gösterilmektedir.

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

Dosya Belirtimini Koruma

Aşağıdaki örnekte gösterildiği gibi her zaman yol ve dosya belirtiminin tamamını tırnak içine almanız gerekir.

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

Dize değişmez değeri içindeki her çift bitişik çift tırnak işareti (" "), dizede bir çift tırnak karakteri olarak yorumlanır. Bu nedenle, yukarıdaki örnekte işleve aşağıdaki dize gösterilir Shell :

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

Yolu tırnak içine almadıysanız, Windows C:\Program Files dizini yerine display.exe C:\ dizininde adlı Program.exe bir dosya arar.

Şunlara uygulanır

Ayrıca bkz.

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