Schedule a task

Create the task

To create a scheduled task, perform the following:

1. Create an instance of your scheduled task class.
2. Set the execution time and other custom properties, if required. You can set the execution time in one of the following ways:
   • Use the ExecutionTime property.
     You sets the exact execution date.
   • Use the ScheduleSpec property.
     You describe the scheduled specification using the cron syntax.
     When using this approach, you need to set the ScheduleSpecType to "crontab".
3. To schedule the task, use the SchedulingManager.

EXAMPLE: The following example demonstrates the use of cron syntax. For more information, seeGenerate crontab expressions.

C#

using System;
using Telerik.Sitefinity.Scheduling;
namespace SitefinityWebApp
{
   public partial class ScheduleTaskSnippets
   {
       public void ScheduleMyScheduleTask()
       {
           SchedulingManager manager = SchedulingManager.GetManager();
           MyScheduledTask newTask = new MyScheduledTask()
           {
               ExecuteTime = DateTime.UtcNow.AddSeconds(10),
               CustomData = new MyScheduledTask.MyCustomData() { MyIntData = 3, MyStringData = "My string data" }
           };
           // With cron syntax
           MyScheduledTask newCronTask = new MyScheduledTask()
           {
               ExecuteTime = DateTime.UtcNow,
               ScheduleSpec = "0 0 * * *", // The task will execute every day at midnight
               ScheduleSpecType = "crontab",
               CustomData = new MyScheduledTask.MyCustomData() { MyIntData = 3, MyStringData = "My string data" }
           };
           manager.AddTask(newTask);
           manager.AddTask(newCronTask);
           manager.SaveChanges();
       }
   }
}

Start a scheduled task manually

You can also execute the scheduled task once using SchedulingManager.RescheduleNextRun() in your Sitefinity CMS widgets or event handlers:

using System;
using System.Linq;
using Telerik.Sitefinity.Scheduling;

namespace SF142
{
   public partial class SitefinitySamples
   {
       public static void SheduleTask()
       {
           DateTime executeTime = DateTime.UtcNow.AddHours(1);

           // Create a new scheduled task
           SchedulingManager schedulingManager = SchedulingManager.GetManager();
           MyScheduledTask newTask = new MyScheduledTask()
           {
               ExecuteTime = executeTime
           };

           schedulingManager.AddTask(newTask);
           SchedulingManager.RescheduleNextRun();
           schedulingManager.SaveChanges();
       }
   }
}