Microsoft KB Archive/305369

= How to wait for a shelled application to finish by using Visual C# =

Article ID: 305369

Article Last Modified on 12/11/2006

-

APPLIES TO


 * Microsoft Visual C# .NET 2002 Standard Edition
 * Microsoft Visual C# 2005

-



This article was previously published under Q305369





For a Microsoft Visual Basic .NET version of this article, see 305368.

For a Microsoft Visual C++ .NET version of this article, see 307388.

This article refers to the following Microsoft .NET Framework Class Library namespace:
 * System.Diagnostics

IN THIS TASK
SUMMARY
 * Requirements
 * Include Namespaces
 * Wait Indefinitely for the Shelled Application to Finish
 * Provide a Time-out for the Shelled Application
 * Troubleshooting

REFERENCES



SUMMARY
This step-by-step article shows you how to use the .NET Framework Process class to start another application from your code and have the code wait for the other application to close before it continues.

When the code waits for the application to finish, there are two options:


 * Wait indefinitely for the other application to either finish or be closed by the user.
 * Specify a time-out period after which you can close the application from your code.

This article presents two code samples that demonstrate both approaches. In addition, the time-out example allows the possibility that the other application may have stopped responding (hung) and takes the necessary steps to close the application.

back to the top

Requirements

 * Microsoft C# .NET or Microsoft C# 2005

back to the top

Include Namespaces
You must import the namespace for the Process class before you run the examples that follow. Place the following line of code before the Namespace or Class declaration that contains the code sample: using System.Diagnostics; back to the top

Wait Indefinitely for the Shelled Application to Finish
The following code sample starts another application (in this case, Notepad) and waits indefinitely for the application to close: //How to Wait for a Shelled Process to Finish //Get the path to the system folder. string sysFolder= Environment.GetFolderPath(Environment.SpecialFolder.System); //Create a new process info structure. ProcessStartInfo pInfo = new ProcessStartInfo; //Set the file name member of the process info structure. pInfo.FileName = sysFolder + @&quot;\eula.txt&quot;; //Start the process. Process p = Process.Start(pInfo); //Wait for the window to finish loading. p.WaitForInputIdle; //Wait for the process to end. p.WaitForExit; MessageBox.Show(&quot;Code continuing...&quot;); back to the top

Provide a Time-out for the Shelled Application
The following code sample sets a time-out for the shelled application. The time-out for the example is set to 5 seconds. You may want to adjust this number (which is calculated in milliseconds) for your testing. //Set a time-out value. int timeOut=5000; //Get path to system folder. string sysFolder= Environment.GetFolderPath(Environment.SpecialFolder.System); //Create a new process info structure. ProcessStartInfo pInfo = new ProcessStartInfo; //Set file name to open. pInfo.FileName = sysFolder + @&quot;\eula.txt&quot;; //Start the process. Process p = Process.Start(pInfo); //Wait for window to finish loading. p.WaitForInputIdle; //Wait for the process to exit or time out. p.WaitForExit(timeOut); //Check to see if the process is still running. if (p.HasExited == false) //Process is still running. //Test to see if the process is hung up. if (p.Responding) //Process was responding; close the main window. p.CloseMainWindow; else //Process was not responding; force the process to close. p.Kill; MessageBox.Show(&quot;Code continuing...&quot;); back to the top

Troubleshooting
Sometimes it may be difficult to choose between these two options. The primary purpose of a time-out is to prevent your application from hanging because the other application has hung. Time-outs are better suited for a shelled application that performs background processing, in which the user may not know that the other application has stalled or does not have a convenient way to close it.

back to the top