Click here to Skip to main content
15,860,859 members
Articles / Programming Languages / C#
Article

Launching a process and displaying its standard output

Rate me:
Please Sign up or sign in to vote.
4.92/5 (62 votes)
31 Aug 2003CPOL5 min read 429.6K   7.6K   166   69
This article shows how to launch a process (such as a bat file, perl script, console program) and have its standard output displayed on a windows form.

Sample Image - LaunchProcess.png

Introduction

I wanted to launch a script from a Windows Form application and display the standard output in a text box as the process was running.  Surely you're not surprised to learn that multithreading is involved.  It turns out you'll have at least four threads running to do this simple task.  To keep things simple and sane, I've reused code from other another source, so I must first give credit to the MSDN article "Give Your .NET-based Application a Fast and Responsive UI with Multiple Threads"  by I.D. Griffiths.  I highly suggest reading this article for more background on multithreading in Windows Forms applications.  Thanks also to Chad Christensen for his suggestions in using a RichTextBox.

Creating a class to call a process

A script or executable can be run using System.Diagnostics.Process.  The string FileName is set to the executable (e.g. perl.exe, Run.bat, ConsoleApplication.exe).  The string Arguments is set to the command-line arguments for that executable (e.g. perlscript.pl, filename1.txt filename2.txt, etc).  The following code will start that executable.

C#
Process process = new Process();
process.StartInfo.UseShellExecute = false;
process.StartInfo.RedirectStandardOutput = true;
process.StartInfo.RedirectStandardError = true;
process.StartInfo.CreateNoWindow = true;
process.StartInfo.FileName = FileName;
process.StartInfo.Arguments = Arguments;
process.StartInfo.WorkingDirectory = WorkingDirectory;
process.Start();

Notice that the standard output and standard error have both been redirected.  There are two StreamReaders in the Process class that can be used to read the output: Process.StandardOutput and Process.StandardError.  Often, the output is not read until after the process has finished, as in the following:

C#
string output = process.StandardOutput.ReadToEnd();

Reading to the end will not work for this application, since we want to read the data as the process is running.

Multiple threads

The solution is to use multiple threads.  One thread is dedicated to running the process and two more threads are dedicated to reading the standard error and standard output.  This is mentioned in MSDN documentation.  Each of these two threads will run a simple function that sits in a loop reading from the stream until the stream is closed.

C#
void ReadStdOut()
{
    string str;
    while ((str = process.StandardOutput.ReadLine()) != null)
    {
        // do something with str
    }
}

After each line is read into str, we would like to notify a windows form to display the text.  Raising an event is probably the best way to accomplish this.  For every new line of text received (on either StandardOutput or StandardError) an event will be raised.  A windows form class can subscribe to these events and update a text box.  Simple, but it won't quite work without some additional work.

Important rule of windows forms

There is an important rule of windows forms and multithreading.  Controls are (almost entirely) not thread safe.  This means that an event raised from any thread other than the UI Thread cannot use methods or properties of a control.  There are a few methods guaranteed to be safe including Control.Invoke and Control.BeginInvoke.  These methods are used to run a function on the UI thread. 

Thankfully, we can inherit from the class AsyncOperation (written by I.D. Griffiths from the above mentioned MSDN article) to solve several problems.  First, this class allows us to raise an event on a UI thread of a hosting or target control.  The above function becomes:

C#
public delegate void DataReceivedHandler(object sender,
    DataReceivedEventArgs e);

public event DataReceivedHandler StdOutReceived;

void ReadStdOut()
{
    string str;
    while ((str = process.StandardOutput.ReadLine()) != null)
    {
        FireAsync(StdOutReceived, this, new DataReceivedEventArgs(str));
    }
}

FireAsync is a method provided by the class AsyncOperation.  It raises an event (or more specifically invokes any delegate) on the UI thread of a form or control.  StdOutReceived is the event that will be raised.  DataReceivedEventArgs is a class derived from EventArgs that has a single string containing the text to be displayed (its definition is not shown here for brevity).

The second thing AsyncOperation provides is a method of canceling a process.  Let's take a look at that class in more detail.

Inheriting from AsyncOperation

AsyncOperation is an abstract base class that assists in creating cancelable worker threads that can fire events back on a UI control (or form).  It provides two main methods that are called by a form class: Start() and Cancel().

AsyncOperation requires that one method be overridden: DoWork(). This method is called when the Start() method is called.  As the method runs, it is expected to watch for a flag CancelRequested that is set from a call to Cancel().  If the flag is true, the method should acknowledge the cancel and return.

The implementation of DoWork() is as follows:

C#
void protected override void DoWork()()
{
    // Start a new process for the cmd
    Process process = new Process();
    process.StartInfo.UseShellExecute = false;
    process.StartInfo.RedirectStandardOutput = true;
    process.StartInfo.RedirectStandardError = true;
    process.StartInfo.CreateNoWindow = true;
    process.StartInfo.FileName = FileName;
    process.StartInfo.Arguments = Arguments;
    process.StartInfo.WorkingDirectory = WorkingDirectory;
    process.Start();


    // Invoke stdOut and stdErr readers - each
    // has its own thread to guarantee that they aren't
    // blocked by, or cause a block to, the actual
    // process running (or the gui).
    new MethodInvoker(ReadStdOut).BeginInvoke(null, null);
    new MethodInvoker(ReadStdErr).BeginInvoke(null, null);

    // Wait for the process to end, or cancel it
    while (! process.HasExited)
    {
        Thread.Sleep(SleepTime); // sleep
        if (CancelRequested)
        {
            // Not a very nice way to end a process,
            // but effective.
            process.Kill();
            AcknowledgeCancel();
        }
    }

}

The methods DoWork()ReadStdOut(), and ReadStdErr(), the properties FileName and Arguments, and the events StdOutReceived and StdErrReceived are all added to a class ProcessCaller which derives from AsyncOperation.  Both classes can be downloaded as part of the zipfile at the top of the page.

The form

As shown in the picture above, the form is quite simple.  It consists of a rich text box to show the standard output and standard input, a button to run a process (Ok), and a button to cancel the process (Cancel).

The Ok button calls the Start() method on ProcessCaller and the Cancel button calls the Cancel() method.  The events StdOutRecieved and StdErrReceived are handled by the following function:

C#
private void writeStreamInfo(object sender, DataReceivedEventArgs e)
{
    this.richTextBox1.AppendText(e.Text + Environment.NewLine);
}

Improvements

Adding a progress bar to the form is one nice improvement for the user interface.  Of course, you have to know the progress of the program being run.  One option is to have the script tell you explicitly in the standard output with lines such as: "Percent completion = 30".  Your "writeStreamInfo" function would filter those lines and update a progress bar.

Standard Error can be displayed in red or some other color (or in a separate rich text box) to highlight any errors found.  At the end of the process, a dialog could be displayed with a list of all errors.

Providing support for standard input shouldn't be too difficult, but integrating it with the windows form may be tough.  Perhaps a separate single-line text box whose contents are sent to the standard input stream through a method on ProcessCaller.

These are just a few ideas of improvements you can make.

Conclusion

Using the class AsyncOperation reduced the design complexity of this program.  Hopefully, the class ProcessCaller will provide you just as much help in reducing the complexity of running scripts and monitoring the output.

Revision History

  • 2003-Jul-31 : Original Post
  • 2003-Aug-05 : Fixed some spelling / grammatical mistakes (oops)

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
United States United States
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
QuestionLaunch process and get its standard output displayed on a console application Pin
Member 1241473930-Nov-22 4:29
Member 1241473930-Nov-22 4:29 
GeneralMy vote of 5 Pin
abberdeen22-Jul-18 12:28
abberdeen22-Jul-18 12:28 
GeneralMy vote of 5 Pin
abberdeen22-Jul-18 12:27
abberdeen22-Jul-18 12:27 
QuestionHow about discovering a secondary process Pin
mwpowellhtx26-Apr-18 20:32
mwpowellhtx26-Apr-18 20:32 
QuestionStartProcess from Class not Form Pin
Eid Shkhaidem15-Nov-17 14:51
Eid Shkhaidem15-Nov-17 14:51 
PraiseThis Is Awesome 2017 and still good Pin
actualmanx4-Nov-17 14:07
actualmanx4-Nov-17 14:07 
QuestionLaunching a process and displaying its standard output Pin
Member 989245626-May-17 13:10
Member 989245626-May-17 13:10 
GeneralMy vote of 5 Pin
Dave Coates14-Dec-16 1:30
Dave Coates14-Dec-16 1:30 
QuestionRunning Multiple process Pin
vinvinodk25-Jun-15 3:21
vinvinodk25-Jun-15 3:21 
GeneralMy vote of 5 Pin
actualmanx19-Feb-14 4:31
actualmanx19-Feb-14 4:31 
QuestionFails to catch exceptions from start process Pin
grafne7919-Aug-11 0:25
grafne7919-Aug-11 0:25 
GeneralDisconnectedContext was detected Errror Pin
Jason_H28-Aug-09 15:48
Jason_H28-Aug-09 15:48 
GeneralWant to do same in Web forms Pin
t_bala1822-Jun-09 15:48
t_bala1822-Jun-09 15:48 
I want to develop same functionality in web forms. I have my build scripts in perl and want to invoke the perl script on a button click and redirect the output from the perl script to a text box in web page through the execution of perl script which takes about 30 minutes.

I am new to C# and web development, can someone help me?

Thanks.
GeneralCaptureConsole.DLL - A Universal Console Output Redirector for all Compilers Pin
Elmue18-Jun-09 13:57
Elmue18-Jun-09 13:57 
QuestionSuspending and resuming the process Pin
ohad-oz21-Nov-08 6:59
ohad-oz21-Nov-08 6:59 
QuestionUsing "redirectstandardinput" with this Pin
immortaldeath19-Sep-08 8:47
immortaldeath19-Sep-08 8:47 
GeneralA bit of a newb here, but figured I would give it a try. Pin
immortaldeath3-Sep-08 18:58
immortaldeath3-Sep-08 18:58 
GeneralAbout the article "Launching a process and displaying the standard output" on Code project Pin
Anupama Sankaran28-Aug-08 8:58
Anupama Sankaran28-Aug-08 8:58 
QuestionTerminate process on standard error Pin
oidele27-Oct-07 10:19
oidele27-Oct-07 10:19 
QuestionGUI blocked Pin
MeJVZ6-Jul-07 8:17
MeJVZ6-Jul-07 8:17 
GeneralYour code does not work always VERY STRANGE Pin
Elmue14-Dec-06 22:08
Elmue14-Dec-06 22:08 
GeneralRe: I found the reason Pin
Elmue15-Dec-06 4:32
Elmue15-Dec-06 4:32 
GeneralRe: I found the reason Pin
RYU^^1-Mar-07 18:10
RYU^^1-Mar-07 18:10 
GeneralRe: I found the reason Pin
cggiriraj17-Mar-08 4:00
cggiriraj17-Mar-08 4:00 
GeneralRe: I found the reason Pin
zeiksz18-Jun-09 0:34
zeiksz18-Jun-09 0:34 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.