The Code Project View our sponsorsGet your new domain name now!Advertise on the CodeProject
Home >> .NET - The Next Generation Internet >> General

Multithreading in .NET
By Uroš Šmon

An article on multithreading in .NET. Three different ways of creating threads in .NET are discussed: simple threads, timers and thread pool. 
 Beginner
 W2K, .NET, C#
 Posted 21 May 2001
Articles by this author
Send to a friend
Printer friendly version
Lounge New Articles Sign in Forums Contribute
Broken links? Email us!
15 users have rated this article. result:
3.8 out of 5.

Introduction

Asynchronous processing and background processing was always a must for serious programs serving complex user needs. The Windows NT platform offers a great way to accomplish this, but the implementation was sometimes tedious and always labor intensive. It is the reason why I first studied multithreading options offered by the .NET framework.

This article shows three different ways of creating (and using) threads, without communication and synchronization between them.

Before you start writing multithreaded programs, bear in mind some guidelines (from MSDN – Threading design guidelines):

Simple threading

Let’s first try the simplest way to create a new thread. The starting point for such a thread is void method with no parameters. Thread creation is done in two steps:

  1. Create a delegate object, initialized with our method
  2. Use this object as an initialization parameter when creating a new Thread object.

When our Thread object is created, call the Start method and background processing will commence.

public class MainClass{
	public void threadMethod(){
		...
	}
	public static void Main(){
		...
		ThreadStart entry = new ThreadStart(threadMethod ) ;
		Thread thread1 = new Thread( entry ) ;
		thread1.Start() ;
		...
	}
}

This sample hides the fact that using C# we do not have a global function, and usually you will start the thread on static class method.

public class Tester{
	public static void Test(){
		...
	}
}
public class MainClass{
	public static void Main()
		...
		ThreadStart entry = new ThreadStart( Tester.Test ) ;
		Thread thread1 = new Thread( entry ) ;
		thread1.Start() ;
		...
	}
}

Now we came to the first beautiful part of the .NET framework. We can start threads on class instances and create real living objects.

public class Tester{
	public void Test(){
		...
	}
}
public class MainClass{
	public static void Main()
		...
		Tester testObject = new Tester() ;
		ThreadStart entry = new ThreadStart( testObject.Test ) ;
		Thread thread1 = new Thread( entry ) ;
		thread1.Start() ;
		...
	}
}

Timer threads

A common use of threads is for all kinds of periodical updates. Under Win32 we have two different ways: window timers and time limited waiting for events. .NET offers three different ways:

For inexact timing we use the window timer. Events raised from the window timer go through the message pump (together with all mouse events and UI update messages) so they are never exact. The simplest way for creating a WinForms.Timer is by adding a Timer control onto a form and creating an event handler using the control's properties. We use the Interval property for setting the number of milliseconds between timer ticks and the Start method to start ticking and Stop to stop ticking. Be careful with stopping, because stopped timers are disabled and are subject to garbage collection. That means that stopped timers can not be started again.

The System.Threading.Timer class is a new waiting thread in the thread pool that periodically calls supplied delegates. Currently it works on Windows 2000 only. Documentation for this class is not finished yet (beta 1). To use it you must perform several steps:

  1. Create state object which will carry information to the delegate
  2. Create TimerCallback delegate with a method to be called. You can use static or instance methods.
  3. Create a Timer object with time to wait before first call and periods between successive calls (as names of this two parameters suggests, first parameter should be lifetime of this timer object, but it just don’t work that way)
  4. Change the Timer object settings with the Change method (same remark on parameters apply)
  5. Kill the Timer object with the Dispose method

If we put this in code we get:

using System;
using System.Threading;

// class for storing current state
public class StateObj{
	...
}

// class that will work on timer request
public class TimerClass{
	public void TimerKick( object state ){
		StateObj param = (StateObj)state ;
		// do some work with param
	}
}

// usage block
{
	...
	// prepare state object
	StateObj state = new StateObj() ;
	// prepare testing object – not necessary when cb is static
	TimerClass testObj = new TimerClass() ;
	// prepare callback delegate – careful on static methods
	TimerCallback tcb = new TimerCallback( obj.TimerKick ) ;
	// make timer
	long waitTime = 2000 ;	// wait before first tick in ms
	long periodTime = 500 ;	// timer period
	Timer kicker = new Timer( tcb, state, waitTime, periodTime ) ;
	// do some work
	...
	kicker.Change( waitTime, periodTime ) ;
	// do some more work
	...
	kicker.Dispose() ;
	...
}

For waitTime and periodTime you can use TimeSpan types if it makes more sense. In the supplied sample you can see that the same state object is used on both timers. When you run the sample the state values printed are not consecutive. I left it like this to show how important synchronization is in a multithread environment.

The final timing options come from the System.Timers.Timer class. It represents server-based timer ticks for maximum accuracy. Ticks are generated outside of our process and can be used for watch-dog control. In the sameSystem.Timers namespace you can find the Schedule class which gives you the ability to schedule timer events fired at longer time intervals.

System.Timers.Timer class is the most complete solution for all time fired events. It gives you the most precise control and timing and is surprisingly simple to use.

  1. Create the Timer object. You can a use constructor with interval setting.
  2. Add your event handler (delegate) to the Tick event
  3. Set the Interval property to the desired number of milliseconds (default value is 100 ms)
  4. Set the AutoReset property to false if you want the event to be raised only once (default is true – repetitive raising)
  5. Start the ticking with a call to the Start() method, or by setting Enabled property to true.
  6. Stop the ticking with call to the Stop() method or by setting the Enabled property to false.
using System.Timers ;

void TickHandler( object sender, EventArgs e ){
	// do some work
}

// usage block
{
	...
	// create timer
	Timer kicker = new Timer() ;
	kicker.Interval = 1000 ;
	kicker.AutoReset = false ;

	// add handler
	kicker.Tick += new EventHandler( TickHandler ) ;

	// start timer
	kicker.Start() ;

	// change interval
	kicker.Interval = 2000 ;

	// stop timer
	kicker.Stop() ;

	// you can start and stop timer againg
	kicker.Start() ;
	kicker.Stop() ;
	...
}

I should mention a few things about using the Timers.Timer class:

Thread pooling

The idea for making a pool of threads on the .NET framework level comes from the fact that most threads in multithreaded programs spend most of the time waiting for something to happen. It means that thread entry functions contain endless loops which calls real working functions. By using the ThreadPool type object preparing working functions is simpler and for bonus we get better resource usage.

There are two important facts relating to ThreadPool object.

The most useful use of a ThreadPool object is to add a new thread with a triggering event to the thread pool. i.e.. "when this event happens do this". For using ThreadPool this way you must perform following steps:

  1. Create event
  2. Create a delegate of type WaitOrTimerCallback
  3. Create an object which will carry status information to the delegate.
  4. Add all to thread pool
  5. Set event

In C#:

// status information object
public class StatusObject{
	// some information
}

// thread entry function
public void someFunc( object obj, bool signaled ){
	// do some clever work
}

// usage block
{
	...
	// create needed objects
	AutoResetEvent myEvent = new AutoResetEvent( false ) ;
	WaitOrTimerCallback myThreadMethod = new WairOrTimerCallback( someFunc ) ;
	StatusObject statusObject = new StatusObject() ;

	// decide how thread will perform
	int timeout = 10000 ;   // timeout in ms
	bool repetable = true ; // timer will be reset after event fired or timeout

	// add to thread pool
	ThreadPool.RegisterWaitForSingleObject( myEvent, myThreadMethod,
						statusObject, timeout, repetable ) ;
	...
	// raise event and start thread
	myEvent.Set() ;
	...
}

A less common use of a thread pool will be (or at least should be, be aware of misuse) adding threads to be executed when the processor is free. You could think of this kind of usage as "OK, I have this to do, so do it whenever you have time". Very democratic way of handling background processing which can stop your program quickly. Remember that inside the thread pool you have only one thread working (per processor).

Using thread pool this way is even simpler:

  1. Create a delegate of type WaitCallback
  2. Create an object for status information, if you need it
  3. Add to thread pool
// status information object
public class StatusObject{
	// some information
}

// thread entry function
public void someFunc( object obj, bool signaled ){
	// do some clever work
}

// usage block
{
	...
	// create needed objects
	WaitCallback myThreadMethod = new WairOrTimerCallback( someFunc ) ;
	StatusObject statusObject = new StatusObject() ;

	// add to thread pool
	ThreadPool.QueueUserWorkItem( myThreadMethod, statusObject ) ;
	...
}

Some notes on thread pool:

Conclusion

This article shows the way I used to find out secrets of .NET multithreading. When you try using this, be careful on thread synchronization. This is also subject of my next article, where I will show all different ways of synchronization that .NET offers.

For more information read articles in MSDN library:

[Top] Sign in to vote for this article:     PoorExcellent  
Hint: For improved responsiveness, use Internet Explorer 4 (or above) with Javascript enabled, choose 'Use DHTML' from the View dropdown and hit 'Set Options'.
 Keyword Filter
 View   Per page   Messages since
New threadMessages 1 to 1 of 1 (Total: 1)First Prev Next Last
Subject 
Author 
Date 
  Lepe pozdrave iz QuickTime d.o.o.
Rok 3:05 25 May 01 
Last Visit: 12:00 Friday 1st January, 1999First Prev Next Last

Home >> .NET - The Next Generation Internet >> General
last updated 21 May 2001
Article content copyright Uroš Šmon, 2001
everything else © CodeProject, 1999-2001.
The Code Project View our sponsorsGet the power of C++ with the ease of VBAdvertise on the CodeProject