Quartz.NET 3.x

These are the documents for the 3.x line, which is maintained. Quartz.NET 4.x is the current release; the migration guide says what changed and what to do about it.

Scheduler Listeners

SchedulerListeners are like ITriggerListeners and IJobListeners, but receive events of the scheduler itself, not necessarily of a specific trigger or job: a job/trigger added or removed, a serious error in the scheduler, the scheduler shutting down, and others.

Caution

Your scheduler listeners must never throw an exception (use a try-catch) and must handle internal problems themselves. When a listener notification fails, Quartz cannot tell whether the listener's required logic completed, and can end up in an unpredictable state.

The ISchedulerListener Interface

public interface ISchedulerListener
{
 Task JobScheduled(Trigger trigger);

 Task JobUnscheduled(string triggerName, string triggerGroup);

 Task TriggerFinalized(Trigger trigger);

 Task TriggersPaused(string triggerName, string triggerGroup);

 Task TriggersResumed(string triggerName, string triggerGroup);

 Task JobsPaused(string jobName, string jobGroup);

 Task JobsResumed(string jobName, string jobGroup);

 Task SchedulerError(string msg, SchedulerException cause);

 Task SchedulerShutdown();
}

Any object implementing ISchedulerListener can be registered with the scheduler's ListenerManager.

Adding a SchedulerListener:

scheduler.ListenerManager.AddSchedulerListener(mySchedListener);

Removing a SchedulerListener:

scheduler.ListenerManager.RemoveSchedulerListener(mySchedListener);