This class is a wrapper for the Windows waitable timer. It is very similar to
System.Timers.Timer, with two important differences: it can wake up a computer from a suspended state (sleep or hibernate), and it supports larger interval values.
I've been writing a class to replicate the Windows Task Scheduler functionality, so recurring events like "at 6PM on last Thursday of March, June, and September every ten minutes for an hour" could be managed programmatically. Upon some research, I found that the standard
System.Timers.Timer (and the underlying
System.Threading.Timer) is not very good to do the job as the interval is limited to 0xffffffff milliseconds (roughly 50 days), as illustrated by:
System.Timers.Timer tmr = new System.Timers.Timer();
tmr.Interval = double.MaxValue;
It is also not possible to resume a computer from power saving mode to execute the task, and this was critical enough for me to start looking at any available alternatives. The
WaitableTimer wrapper class provides such an alternative for you. Enjoy!
Using the code
As you will see, the
WaitableTimer class is very similar to
System.Timers.Timer in regard to properties, methods, and events. There should be no learning curve as such, and the only new property introduced is
true, this property tells the timer that it should wake up a computer to run the
Elapsed event handlers:
WaitableTimer timer = new WaitableTimer();
timer.ResumeSuspended = true;
timer.Interval = 60000;
As you can see, I had to recreate
System.Timers.Timer's does not have a public constructor. The demo project attached will simulate the
Sleep (and with one simple change,
Hibernate) mode after starting the timer, so you will see it in action.
Due to the nature of
Hibernate modes, the timer will not be very accurate as the machine has to be completely awake to run the task, and this takes some time. You should also keep in mind that if you have a different OS first on your startup list (like the default Ubuntu on my machine), resuming from hibernation could unexpectedly load that OS.
The demo project is written in C# 2008, and will not compile properly in older versions, but the classes should not be dependent on the C# version.
Sleep mode in the demo project is implemented via the
WindowsController class by the KPD team. The XML comments are stolen from the
System.Timers namespace. The
WaitableTimer is documented by MSDN.
- November 2008 - initial release.