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

Make Your Application Shutdown Aware

Rate me:
Please Sign up or sign in to vote.
4.25/5 (32 votes)
27 Jan 2008CPOL2 min read 74.1K   1.2K   63   6
This article explains how to make your application shutdown aware

Image 1

CloseCheck_2.png

CloseCheck_3.png

Introduction

This article is not an out of the box article. However I feel this may bring in some more ideas in the field of application development because knowledge makes you think beyond limitation.

Background

I was working with one application and my client wanted the application to be system shutdown aware. I remembered that lot many applications do some task based on closing of an application but rarely saw any application which differentiated user shutdown and system shutdown. I thought why not make people aware that there is something which may change in the application design.

I have seen a couple of applications which handle FormClosing event and show MessageBox of closing, but when system shutdown is requested, they still show the message and end up with either data loss or prevent system shutdown.

So I decided to put this in the form of an article.

Basic Idea

FormClosingEventArgs is derived from CancelEventArgs. FormClosingEventArgs has a property (CloseReason) which tells you the reason for closing. This may be used in identifying and handling the close reason.

Now you have two options to get this arguments during close.

  1. You can override OnClosing method declared in Form and cast CancelEventArgs e to FormClosingEventArgs:

    C#
    protected override void OnClosing(CancelEventArgs e) 
    { 
        //Your alternate implementation
        FormClosingEventArgs ce = e as FormClosingEventArgs; 
        if (ce != null) 
        {
            //Handle ce
        }
        base.OnClosing(e); 
    }
  2. You can use event FormClosing:

    C#
    private void SampleForm_FormClosing(object sender, FormClosingEventArgs e)
    {
        //Your alternate implementation
    }

Handle Close Scenario

C#
switch (ce.CloseReason)
{
    case CloseReason.ApplicationExitCall:
        //Handle application exit call
        break;
    case CloseReason.FormOwnerClosing:
        //Handle Form owner close
        break;
    case CloseReason.MdiFormClosing:
        //Handle MDI parent closing
        break;
    case CloseReason.None:
        //Handle unknown reason
        break;
    case CloseReason.TaskManagerClosing:
        //Handle taskmanager close
        break;
    case CloseReason.UserClosing:
        Handle User close
        break;
    case CloseReason.WindowsShutDown:
        //Handle system shutdown
        break;
}

Points of Interest

If you go through the MSDN documentation, you will find the following details of CloseReason. The names itself are self explanatory:

  • ApplicationExitCall - The Exit method of the application class was invoked.
  • FormOwnerClosing - The owner form is closing.
  • MdiFormClosing - The parent form of this multiple document interface (MDI) form is closing.
  • None - The cause of the closure was not defined or could not be determined.
  • TaskManagerClosing - The Microsoft Windows Task Manager is closing the application.
    UserClosing - The user is closing the form through the user interface (UI), for example by clicking the Close button on the form window, selecting Close from the Window's control menu, or pressing ALT+F4.
  • WindowsShutDown - The operating system is closing all applications before shutting down.

History

  • 28th January, 2008: Initial post

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)
India India
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
GeneralIf only FormClosingEventArgs worked for PocketPC [modified] Pin
jlwarlow4-Jun-10 3:36
jlwarlow4-Jun-10 3:36 
Generalsome issue Pin
arif.setiawan24-Feb-10 14:10
arif.setiawan24-Feb-10 14:10 
GeneralThis is also limited to applications using forms Pin
bjreed6-Feb-08 5:23
bjreed6-Feb-08 5:23 
GeneralRe: This is also limited to applications using forms Pin
Manish Ranjan Kumar8-Feb-08 20:55
professionalManish Ranjan Kumar8-Feb-08 20:55 
Yes, this is meant for windows application only.
Questionclosereason is only helpful for legal shutdowns... what about illegal ones? Pin
E. del Ayre28-Jan-08 19:32
E. del Ayre28-Jan-08 19:32 
AnswerRe: closereason is only helpful for legal shutdowns... what about illegal ones? Pin
yannlh20-Aug-08 16:14
yannlh20-Aug-08 16:14 

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.