Article ID: 305368 - Last Review: December 6, 2006 - Revision: 2.3

How to wait for a shelled application to finish by using Visual Basic 2005 or Visual Basic .NET

View products that this article applies to.
This article was previously published under Q305368
For a Microsoft Visual C# .NET version of this article, see 305369  (http://support.microsoft.com/kb/305369/ ) .
For a Microsoft Visual C++ version of this article, see 307388  (http://support.microsoft.com/kb/307388/EN-US/ ) .
For a Microsoft Visual Basic 6.0 version of this article, see 129796  (http://support.microsoft.com/kb/129796/ ) .

On This Page

Expand all | Collapse all

SUMMARY

This article demonstrates 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 Visual Basic 2005 or Microsoft Visual Basic .NET
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 name of the system folder.
     Dim sysFolder As String = _
                 Environment.GetFolderPath(Environment.SpecialFolder.System)
    'Create a new ProcessStartInfo structure.
    Dim pInfo As New ProcessStartInfo()
    'Set the file name member of pinfo to Eula.txt in the system folder.
    pInfo.FileName = sysFolder & "\eula.txt"
    'Start the process.
    Dim p As Process = Process.Start(pInfo)
    'Wait for the process window to complete loading.
    p.WaitForInputIdle()
    'Wait for the process to exit.
    p.WaitForExit()
    'Continue with the code.
    MessageBox.Show("Code continuing...")
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 this 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.
    Dim timeOut As Integer = 5000
    'Get the path to the system folder.
    Dim sysFolder As String = _
         Environment.GetFolderPath(Environment.SpecialFolder.System)
    'Create a new ProcessStartInfo structure.
    Dim pInfo As New ProcessStartInfo()
    'Set the file name member of pinfo to Eula.txt in the system folder.
    pInfo.FileName = sysFolder & "\eula.txt"
    'Start the process. 
    Dim p As Process = Process.Start(pInfo)
    'Wait for the process window to complete loading.
    p.WaitForInputIdle()
    'Wait for the process to exit.
    p.WaitForExit(timeOut)
    'HasExited is true if the application closed before the time-out.
    If p.HasExited = False Then
        'Process is still running.
        'Test to see if process is hung up.
        If p.Responding Then
            'Process was responding; close the main window.
            p.CloseMainWindow()
        Else
            'Process was not responding; force the process to close.
            p.Kill()
        End If
    End If
    MessageBox.Show("Code continuing...")
Back to the top

Troubleshooting

Sometimes it may be difficult to choose between these two options. The primary purpose of setting 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 and does not have a convenient way to close it.
Back to the top

REFERENCES

For more information about the Process class, see the following .NET Framework Class Library documentation:
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpref/html/frlrfSystemDiagnosticsProcessClassTopic.asp (http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpref/html/frlrfSystemDiagnosticsProcessClassTopic.asp)
For more information, click the following article number to view the article in the Microsoft Knowledge Base:
306394  (http://support.microsoft.com/kb/306394/ ) How to determine when a shelled process ends in Visual Basic .NET or in Visual Basic 2005
Back to the top
APPLIES TO
  • Microsoft Visual Basic 2005
  • Microsoft Visual Basic .NET 2003 Standard Edition
  • Microsoft Visual Basic .NET 2002 Standard Edition
Back to the top
Keywords: 
kbvs2005applies kbvs2005swept kbhowtomaster KB305368
Back to the top
 

Get Help Now

Contact a support professional by E-mail, Online, or Phone

Article Translations