Click here to Skip to main content
13,345,438 members (51,000 online)
Click here to Skip to main content
Add your own
alternative version


210 bookmarked
Posted 30 Sep 2004

A component for event scheduling inside an application

, 30 Sep 2004
Rate this:
Please Sign up or sign in to vote.
This article presents the design and a readily usable component for scheduling events which are consumed inside a server or service application.


Every typical server or service application need scheduling of some events inside the application. These events generally are supposed to wake up at certain determined times to do self checks, check statuses of threads, or typically refresh resources once in a while, and so on. This requires shorter and long time scheduling of events inside the application. The most common approach is to use timers for different tasks and attach them to threads. A scheduler component is presented in this article for simplifying a way to create and maintain event scheduling inside an application.

Using the code

The best example to create and use the Schedule classes is in the demo application. This piece of code inside the demo creates all the types of schedule objects implemented in the library, and also provides a delegate ScheduleCallBack() for the schedule to call back for OnTrigger event.

// create and add different types of schedules
Schedule s = new IntervalSchedule("Test_Interval", 
             DateTime.Now.AddMinutes(1), 45, TimeSpan.Zero, 
             new TimeSpan(TimeSpan.TicksPerDay));
s.OnTrigger += new EventScheduler.Invoke(ScheduleCallBack);

s = new OneTimeSchedule("Test_Onetime", DateTime.Now.AddMinutes(1.5));
s.OnTrigger += new EventScheduler.Invoke(ScheduleCallBack);

s = new DailySchedule("Test_daily", DateTime.Now.AddMinutes(2));
s.OnTrigger += new EventScheduler.Invoke(ScheduleCallBack);

s = new WeeklySchedule("Test_weekly", DateTime.Now.AddMinutes(2.5));
s.OnTrigger += new EventScheduler.Invoke(ScheduleCallBack);

s = new MonthlySchedule("Test_monthly", DateTime.Now.AddMinutes(3));
s.OnTrigger += new EventScheduler.Invoke(ScheduleCallBack);

As can be seen, the three main lines are to:

  • create a Schedule instance
  • subscribe to the OnTrigger event, and
  • add the Schedule to the Scheduler's list

That's it! To see this in action, run the demo application shown below and click on Test Code button. This will create an instance of each schedule and gives a feeling of what the scheduler can do.

Design and Code details

The following class diagram shows the different classes in the scheduler library and their relationship.

At the root of the library is the Schedule class which implements IComparable interface. The IComparable interface provides the CompareTo(Object) method which is used to compare two Schedule objects for sorting the list of schedules to determine the sequence of invocation times for the timer.

The library already provides general Schedules like OneTimeSchedule (used for raising an event only once), IntervalSchedule (used to raise an event at regular intervals), DailySchedule, WeeklySchedule and MonthlySchedule, which are self explanatory. The Schedule base class has generic properties like Name, Type, NextInvokeTime etc. used by all derived objects, and some specific properties like Interval which is used in this case only by IntervalSchedule.

These are the steps through which the Scheduler goes through for scheduling an event:

  • A static timer (Scheduler.Timer) with a call back method (DispatchEvents) is created and initially put to sleep.
  • Schedules are created either by code or by GUI. Individual conditions are checked in the Schedule's constructor.
  • When ever a Schedule object is added to the Scheduler using AddSchedule(Schedule s) method:
    • the list is sorted. The list which is an ArrayList in turn uses the Schedule.CompareTo(Object) method to determine the sorting order.
    • the NextInvokeTime of the first element in the list is used by the Timer to decide when to wake up next.
  • When the Timer wakes up:
    • it calls DispatchEvents call back
    • which calls TriggerEvents() on the first Schedule object in the list

A Schedule's view GUI is also provided with the library to manage the schedules through a GUI as a singleton class (ScheduleUI) which is created by the static method ScheduleUI.ShowSchedules(). This GUI uses the Scheduler.OnSchedulerEvent event provided by Scheduler to track when a Schedule is created, deleted, or invoked.

Typically, this GUI can be used for administration of schedules and also to create or delete them easily. Once a schedule is created, it can be accessed programmatically using Scheduler events or the name of the Schedule itself.

For e.g., the following code inside ScheduleUI class shows how the Scheduler events are used to refresh the list of Schedules.

public void OnSchedulerEvent(SchedulerEventType type, string scheduleName)
        case SchedulerEventType.CREATED:
            ListViewItem lv = SchedulesView.Items.Add(scheduleName);
            Schedule s = Scheduler.GetSchedule(scheduleName);
            lv.SubItems.Add(s.NextInvokeTime.ToString("MM/dd/yyyy hh:mm:ss tt"));
        case SchedulerEventType.DELETED:
            for (int i=0; i<SchedulesView.Items.Count; i++)
                if (SchedulesView.Items[i].Text == scheduleName)
        case SchedulerEventType.INVOKED:
            for (int i=0; i<SchedulesView.Items.Count; i++)
                if (SchedulesView.Items[i].Text == scheduleName)
                    Schedule si = Scheduler.GetSchedule(scheduleName);
                    SchedulesView.Items[i].SubItems[2].Text =
                        si.NextInvokeTime.ToString("MM/dd/yyyy hh:mm:ss tt");

Another critical piece of code is the bool[] m_workingWeekDays array in the Schedule base class, in which the active week days are stored. The bool NoFreeWeekDay() and bool CanInvokeOnNextWeekDay() use this array to determine if a schedule can run on a week day.

Similarly, the bool IsInvokeTimeInTimeRange() determines if a schedule can run in a time range on any given day. Please refer to comments in the code if you are interested to get into the details.


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

Sriram Chitturi
United States United States
No Biography provided

You may also be interested in...


Comments and Discussions

GeneralRe: New version Pin
dima polyakov23-Sep-07 11:56
memberdima polyakov23-Sep-07 11:56 
GeneralRe: New version Pin
samphil26-Sep-07 3:40
membersamphil26-Sep-07 3:40 
GeneralRe: New version Pin
dima polyakov26-Sep-07 6:07
memberdima polyakov26-Sep-07 6:07 
GeneralPerhaps you should read up on 'lock' Pin
robvon19-Sep-07 0:20
memberrobvon19-Sep-07 0:20 
GeneralFIX - Intervals were not expiring. Pin
kurios23-Aug-07 12:22
memberkurios23-Aug-07 12:22 
GeneralPlz upload the updated version Pin
Bill_Gates26-Feb-07 22:01
memberBill_Gates26-Feb-07 22:01 
GeneralNew Programmer Pin
Doritkatz21-Jan-07 0:28
memberDoritkatz21-Jan-07 0:28 
GeneralRe: New Programmer Pin
tridex18-Jun-07 4:48
membertridex18-Jun-07 4:48 
Goto this page and get this great tool to help ypu learn how others doit!!!

Dissasembler called : .NET Reflector.....

Questiona gread deal of schedues will to run Pin
hou12614-Nov-06 14:39
memberhou12614-Nov-06 14:39 
GeneralA great article Pin
Asad_KA22-Sep-06 11:59
memberAsad_KA22-Sep-06 11:59 
QuestionEvent Scheduler Pin
Nicos Andreou21-Sep-06 0:01
memberNicos Andreou21-Sep-06 0:01 
QuestionHow to have params passed into ScheduleCallBack Pin
hannalu14-Feb-06 13:33
memberhannalu14-Feb-06 13:33 
AnswerRe: How to have params passed into ScheduleCallBack Pin
BraveShogun19-Dec-06 2:45
memberBraveShogun19-Dec-06 2:45 
Generalsupport / bugfixes Pin
Kylixs9-Oct-05 8:05
memberKylixs9-Oct-05 8:05 
GeneralRe: support / bugfixes [modified] Pin
Gonzalo Brusella23-Jun-06 10:10
memberGonzalo Brusella23-Jun-06 10:10 
GeneralRe: support / bugfixes Pin
Danilo Corallo30-Aug-06 4:37
memberDanilo Corallo30-Aug-06 4:37 
GeneralRe: support / bugfixes Pin
Gonzalo Brusella30-Aug-06 5:23
memberGonzalo Brusella30-Aug-06 5:23 
GeneralThreads problem Pin
fredrikp22-Aug-05 6:20
memberfredrikp22-Aug-05 6:20 
GeneralRe: Threads problem Pin
Anonymous28-Aug-05 14:16
sussAnonymous28-Aug-05 14:16 
GeneralNovice User How to integrate with existing code Pin
ckandreou21-Jun-05 11:29
memberckandreou21-Jun-05 11:29 Pin
tobbylee1325-May-05 10:06
membertobbylee1325-May-05 10:06 
GeneralRe: Pin
Benjamin Hall14-Jun-05 14:04
memberBenjamin Hall14-Jun-05 14:04 
GeneralRe: Pin
Doritkatz21-Jan-07 0:27
memberDoritkatz21-Jan-07 0:27 
QuestionRe: Pin
corym26-Jul-07 3:39
membercorym26-Jul-07 3:39 
GeneralWeekdays bug Pin
yesildal8-Apr-05 17:59
memberyesildal8-Apr-05 17:59 

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.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.180111.1 | Last Updated 1 Oct 2004
Article Copyright 2004 by Sriram Chitturi
Everything else Copyright © CodeProject, 1999-2018
Layout: fixed | fluid