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

How to call a long running method asynchronously and display a wait image on the UI

Rate me:
Please Sign up or sign in to vote.
2.50/5 (5 votes)
27 Aug 2008CPOL2 min read 47.6K   664   34   10
This article explains how to call a long running method asynchronously and also display a wait image on the UI.

Introduction

This article describes how to call a long running method asynchronously on a separate thread and also display a wait image until the thread is not done executing a task.

Background

There have been many situations where developers have to run a function/method/programming logic that takes substantially longer than usual. In that case, it's always recommended to run it asynchronously in a separate thread and also display a wait message/image to the end user. This sample application will explain how this can be achieved.

Using the Code

First, I have declared two delegates in class Form1. LoadDataDelegate is used to call the long running method asynchronously, and it takes the key as a parameter (just to show a parameterized sample). DisplayWaitDelegate is used to display/hide the wait image. It takes a boolean parameter to set whether to display or hide.

C#
//declare a delegate to run the Load method in a separate thread
delegate void LoadDataDelegate(string key);
//declare a delegate to call the Display Wait method
delegate void DisplayWaitDelegate(bool boolDisplay);

The following code is in my Load Data button click event. I will explain the function DisplayWait later, but this is used to display the wait image. The function "LoadData" in Class1 takes longer to execute, so I have instantiated the LoadDataDelegate delegate and passed in this function name. Finally, call BeginInvoke to start. Notice the second parameter which is a function name (which is explained later) is called when this asynchronous call / thread is completed.

C#
private void btnLoadData_Click(object sender, EventArgs e)
{
    //will be calling the long running methid, so diaplay the wait image
    DisplayWait(true);
    string key = textBox1.Text;
    Class1 objClass1 = new Class1();

    //Create an instance of the Load delegate and pass in the Function Name
    LoadDataDelegate delLoadData = new LoadDataDelegate(objClass1.LoadData);

    //Since we want to call the Load function
    //asynchronously on another thread, use BeginInvoke. The next
    //argument is the function name being called once this thread is completed
    delLoadData.BeginInvoke(key, this.LoadComplete, delLoadData);
}

Following is the code for the LoadComplete function. This function gets the handle for the delegate and calls the EndInvoke method to stop the asynchronous call. The function DisplayWait is called again, but this time with the parameter boolean value as false, which hides the wait image.

C#
private void LoadComplete(IAsyncResult ar)
{
    LoadDataDelegate d = (LoadDataDelegate)ar.AsyncState;

    //end the Load method call
    d.EndInvoke(ar);

    //now when the Load is complete..remove the wait image
    DisplayWait(false);

    MessageBox.Show("Data Load Completed.");
}

Following is the code for the DisplayWait function. The pcitureBox1 control contains the wait image. The InvokeRequired call is needed to ensure this program doesn't cause any cross thread exception. Again, create an instance of DisplayWaitDelegate and pass the same method name "DisplayWait". Then call the Invoke method of the control (in this case, pictureBox1) and pass the delegate instance and parameters in an array of objects (in this case, just one parameter).

Now, this will call the function DisplayWait again, and this time, it will go in the else block, and there I'm setting up the visibility. I'm also setting up the UseWaitCursor property at the Form level to display the hour glass when the wait image is being displayed.

C#
private void DisplayWait(bool boolDisplay)
{
    //this check is required to carry out the cross thread 
    //oprtation on a control which is pictureBox1 in this case.
    if (pictureBox1.InvokeRequired)
    {
        // this is worker thread
        DisplayWaitDelegate del = new DisplayWaitDelegate(DisplayWait);
        pictureBox1.Invoke(del, new object[] { boolDisplay });
    }
    else
    {
        // this is UI thread 
        pictureBox1.Visible = boolDisplay;
        UseWaitCursor = boolDisplay;
    }
}

Now the last but not the least, the function "LoadData" in Class1, which is nothing but Thread.Sleep(10000) to show a sample delay of 10 seconds with this application.

C#
//long running method 
public void LoadData(string key) 
{
    // The actual method imlementation
    //just for sample delay added the sleep for 10 seconds
    Thread.Sleep(10000); 
}

Points of Interest

This can also be extended to show a progress bar.

History

  • Version 1.0: 08/22/2008.

License

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


Written By
Software Developer (Senior) Nu Info Systems
United States United States
I have worked extensively in microsoft technologies for over 8 years now. I have worked on some pretty big size development projects and love progamming in C#, .Net. In my spare time I love reading, blogging and spending time with family.

Comments and Discussions

 
Generalbundle of thanks Pin
Hassue Rana9-Sep-12 16:45
professionalHassue Rana9-Sep-12 16:45 
Questioncan I use this in web application? Pin
mariagp17-Oct-08 9:33
mariagp17-Oct-08 9:33 
GeneralUse BackGroundWorker Pin
Abhijit Jana27-Aug-08 17:41
professionalAbhijit Jana27-Aug-08 17:41 
RantRe: Use BackGroundWorker Pin
Ilíon28-Aug-08 1:21
Ilíon28-Aug-08 1:21 
GeneralBackgroundThread Pin
Itay Sagui27-Aug-08 6:41
Itay Sagui27-Aug-08 6:41 
GeneralRe: BackgroundThread Pin
marco_br27-Aug-08 7:12
marco_br27-Aug-08 7:12 
GeneralRe: BackgroundThread Pin
BillW3327-Aug-08 9:48
professionalBillW3327-Aug-08 9:48 
RantBackgroundThread ... useful if you have it Pin
Ilíon28-Aug-08 1:20
Ilíon28-Aug-08 1:20 
GeneralRe: BackgroundThread ... useful if you have it Pin
rcollina28-Aug-08 3:20
rcollina28-Aug-08 3:20 
GeneralRe: BackgroundThread ... useful if you have it Pin
Ilíon28-Aug-08 4:16
Ilíon28-Aug-08 4:16 

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.