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

The key to multi-threaded Windows Forms UI interaction

Rate me:
Please Sign up or sign in to vote.
4.60/5 (41 votes)
5 Apr 2002BSD3 min read 302K   8K   93   44
Teaches how to use the Invoke functionality so that interaction with UI elements can be safely done.

Sample Image - winformsthreading.jpg

Introduction

I don't intend for this article to teach multi-threaded programming in .NET, I do want to point out some important things when dealing with multi-threaded programs in a Windows Forms environment.  This article will be code light, however I have provided a full sample illustrating how to employ the practices required of a Multi-Threaded Windows Forms application.

What not to do

First and foremost (and the reason I'm writing this article) is that you absolutely, positively, cannot interact with UI elements from a thread that did not create them.  You may get away with it in some cases, but it will fail at some point and then heads will roll because you will have a lot of code to change.  Now you may ask how should you interact with the UI from another thread. 

What you should do

Luckily the designers for Windows Forms realized the plight that may be caused without being able to interact with the UI from another thread.  So they add the Invoke method to the Control class.  Invoke runs the specified delegate on the thread that create the control's window (or the parents window if it doesn't have one).

C#
public void Invoke(System.Delegate delegate);
public void Invoke(System.Delegate delegate, object [] args);

The second form of Invoke takes an object array containing any parameters you wish to be passed into the delegate.  For those still not used to delegates, think of them as the .NET way to use function pointers.

A brief example

A simple example of using this is to create a new form, add a textbox and a button to it.  Call the textbox myTextbox.

At the top of the code file add another using statement for the threading library.

C#
using System.Threading;

In the button's Click event place the following code.

C#
Thread t = new Thread(new ThreadStart(SayHiThread));
t.IsBackground = true;
t.Start();

Now add this code to the form

C#
private void SayHiThread()
{
	Invoke(new SayHiDelegate(SayHi), new object [] { "Hello from the thread" });
}
C#
private void SayHi(string msg)
{
	myTextbox.Text = msg;
}

Outside of the form's class add this declaration

C#
public delegate void SayHiDelegate(string msg);

Run the application and click the button, the textbox should now say "Hello from the thread".

What it did

Well that probably confused you more than it helped so I'll try to explain piece by piece what it does.

The Invoke method requires an instance of a delegate.  A delegate is nothing more than a type-safe function pointer.  You declare a delegate by creating the function signature you wish to have, then preceding the signature with the delegate keyword.  In the example above the function will take a string as its only parameter and return nothing.  You create a new delegate instance as if you were creating an instance of a class, except you pass in the name of the method you want the delegate to call.

The code inside of the button's click event creates a new thread, sets it as a background thread, then runs it.  All the thread does is run the function SayHiThread.  The thread only does one thing, it calls Invoke on the form (since SayHiThreadis a member of the form it calls the form's Invoke method).   The Invoke method takes an instance of a delegate, and an object array containing the parameters to give to the delegate.  In this case there is only one parameter; a string. 

To sum it up, Invoke calls the function which the delegate points to, passing in the parameters in the object array.

Summary

When you get down to it the hardest part of writing the code to interact with the UI from another thread is getting to understand delegates and how to use them.  As always, if there are any questions e-mail me or post them below. The source/demo show a example that's a bit more advanced, but still nothing too advanced.

License

This article, along with any associated source code and files, is licensed under The BSD License


Written By
Software Developer (Senior) InfoPlanIT, LLC
United States United States
James has been programming in C/C++ since 1998, and grew fond of databases in 1999. His latest interest has been in C# and .NET where he has been having fun writing code starting when .NET v1.0 was in its first beta.

He is currently a senior developer and consultant for InfoPlanIT, a small international consulting company that focuses on custom solutions and business intelligence applications.

He was previously employed by ComponentOne where he was a Product Manager for the ActiveReports, Data Dynamics Reports, and ActiveAnalysis products.

Code contained in articles where he is the sole author is licensed via the new BSD license.

Comments and Discussions

 
GeneralRe: Cannot use Invoke if calling Join inside Closing event - causes deadlock Pin
JoergB15-Apr-03 18:57
JoergB15-Apr-03 18:57 
GeneralThreaded Progress Bar Pin
jtmtv1813-Mar-03 13:16
jtmtv1813-Mar-03 13:16 
GeneralRe: Threaded Progress Bar Pin
James T. Johnson14-Mar-03 14:13
James T. Johnson14-Mar-03 14:13 
GeneralRe: Threaded Progress Bar Pin
jtmtv1815-Mar-03 7:47
jtmtv1815-Mar-03 7:47 
GeneralRe: Threaded Progress Bar Pin
James T. Johnson14-Apr-03 6:35
James T. Johnson14-Apr-03 6:35 
GeneralTrillian Skin Pin
this is a test23-Feb-03 8:17
this is a test23-Feb-03 8:17 
GeneralRe: Trillian Skin Pin
James T. Johnson14-Mar-03 14:19
James T. Johnson14-Mar-03 14:19 
QuestionIs it possible to start multiple forms (MDI) each in separate thread ? Pin
Davorin P. A.23-Sep-02 20:49
sussDavorin P. A.23-Sep-02 20:49 
AnswerRe: Is it possible to start multiple forms (MDI) each in separate thread ? Pin
James T. Johnson23-Sep-02 23:54
James T. Johnson23-Sep-02 23:54 
GeneralRe: Is it possible to start multiple forms (MDI) each in separate thread ? Pin
davorin p.24-Sep-02 20:49
davorin p.24-Sep-02 20:49 
GeneralA little understanding.. Pin
David Wengier6-Apr-02 9:54
David Wengier6-Apr-02 9:54 
GeneralRe: A little understanding.. Pin
James T. Johnson6-Apr-02 12:49
James T. Johnson6-Apr-02 12:49 
GeneralRe: A little understanding.. Pin
Nish Nishant6-Apr-02 14:33
sitebuilderNish Nishant6-Apr-02 14:33 
GeneralRe: A little understanding.. Pin
James T. Johnson6-Apr-02 14:31
James T. Johnson6-Apr-02 14:31 
GeneralRe: A little understanding.. Pin
Neville Franks8-Apr-02 0:37
Neville Franks8-Apr-02 0:37 
GeneralRe: A little understanding.. Pin
7-May-02 8:50
suss7-May-02 8:50 
GeneralRe: A little understanding.. Pin
HAHAHA_NEXT2-Mar-04 9:20
HAHAHA_NEXT2-Mar-04 9:20 
GeneralGo Hasaki, go! Pin
Nish Nishant6-Apr-02 3:57
sitebuilderNish Nishant6-Apr-02 3:57 
GeneralRe: Go Hasaki, go! Pin
James T. Johnson6-Apr-02 4:02
James T. Johnson6-Apr-02 4:02 

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.