Easily Create Repeating or Recurring Appointments Using WPF Scheduler

Suresh Mohan - Apr 26 '22 - - Dev Community

The WPF Scheduler is used to schedule day-to-day appointments, and it also makes it easy to maintain repeating appointments such as anniversaries, birthdays, or meetings that occur on different dates at the same time.

In this blog post, we’ll see how to easily create and manage repeating appointments using the WPF Scheduler control.

Note: If you are new to our Scheduler control, please read the Getting Started with WPF Scheduler documentation before proceeding.

Let’s look at the different recurrence patterns!

Recurrence pattern

The recurrence pattern rule contains the following details of the repeating appointment:

  • Recurrence Frequency : Specifies the repeat type as daily, weekly, monthly, or yearly.
  • Recurrence Interval : Specifies the time interval between the recurring appointments.
  • Recurrence End Range : The recurrence end range is based on a specific end date or the number of occurrences.

Daily recurring events

Create events that occur every day and at the same time.

Examples:

You can create daily recurring appointments with count, end date, or no end date details.

//Daily recurrence pattern with count.
FREQ=DAILY;INTERVAL=1;COUNT=5

//Daily recurrence pattern with end date.
FREQ=DAILY;INTERVAL=1;UNTIL=20200725

//Daily recurrence pattern with no end date.
FREQ=DAILY;INTERVAL=2;
Enter fullscreen mode Exit fullscreen mode

Weekly recurring events

Create events that occur on certain days every week.

Examples:

You can create weekly recurring appointments by specifying the count or end date with days of the week.

//Weekly recurrence pattern with count and day of week.
FREQ=WEEKLY;INTERVAL=2;BYDAY=WE;COUNT=20

//Weekly recurrence pattern with end date and day of week.
FREQ=WEEKLY;INTERVAL=1;BYDAY=TU,FR;UNTIL=20200811

//Weekly recurrence pattern with no end date.
FREQ=WEEKLY;INTERVAL=2;BYDAY=MO,WE;
Enter fullscreen mode Exit fullscreen mode

Monthly recurring events

Create recurring events that occur on a certain day of a month or a certain day of a week every month.

Examples:

//Monthly recurrence pattern with count and month day.
FREQ=MONTHLY;BYMONTHDAY=3;INTERVAL=1;COUNT=10

//Monthly recurrence pattern with end date, day of week, and week position.
FREQ=MONTHLY;INTERVAL=1;BYDAY=MO;BYSETPOS=2;UNTIL=20200725

// Monthly recurrence pattern with no end date.
FREQ=MONTHLY;BYMONTHDAY=3;INTERVAL=2;
Enter fullscreen mode Exit fullscreen mode

Yearly recurring events

Create recurring events that occur on a certain day of the month or a certain day of a week in the month that repeat every year.

Examples:

//Yearly recurrence pattern with month and month day and end date.
FREQ=YEARLY;BYMONTHDAY=15;BYMONTH=5;INTERVAL=1; UNTIL=20230618

//Yearly recurrence pattern with count, month and week day and week position. 
FREQ=YEARLY;BYDAY=TH;BYSETPOS=2;BYMONTH=6;INTERVAL=1;COUNT=10

//Yearly recurrence pattern with no end date.
FREQ=YEARLY;BYDAY=SU;BYSETPOS=3;BYMONTH=8;INTERVAL=2;
Enter fullscreen mode Exit fullscreen mode

How to create recurring appointments in WPF Scheduler

Follow these steps to create repeating appointments in the WPF Scheduler:

  1. First, initialize the Syncfusion WPF Scheduler control. 
xmlns:scheduler="using:Syncfusion.UI.Xaml.Scheduler"

<syncfusion:SfScheduler x:Name="Schedule"
                          ViewType="Week"
                          ItemsSource="{Binding AppointmentCollection}"&gt;
</syncfusion:SfScheduler>
Enter fullscreen mode Exit fullscreen mode
  1. Then, create repeating events with the recurrence rule and add them to the Scheduler’s ItemsSource. 
// Creating an instance for the Scheduler appointment collection.
var appointmentCollection = new ScheduleAppointmentCollection();

//Adding schedule appointment in appointment collection
var scheduleAppointment = new ScheduleAppointment()
{
  Id = 1,
  StartTime = new DateTime(2022, 3, 20, 11, 0, 0),
  EndTime = new DateTime(2022, 3, 20, 12, 0, 0),
  Subject = "Occurs every alternate day",
  AppointmentBackground = Brushes.RoyalBlue,
  Foreground = Brushes.White,
};

//Creating the recurrence rule.
scheduleAppointment.RecurrenceRule = "FREQ=DAILY;INTERVAL=2;COUNT=10";

//Adding schedule appointment to the appointment collection.
appointmentCollection.Add(scheduleAppointment);

//Setting the appointment collection to the ItemsSource of the SfScheduler.
Schedule.ItemsSource = appointmentCollection;
Enter fullscreen mode Exit fullscreen mode

Daily Recurring Appointments in WPF Scheduler

Daily Recurring Appointments in WPF Scheduler

Note: To learn more, refer to the recurring appointments in the WPF Scheduler demo.

Create recurrence exception appointment

It is also possible to remove or reschedule the event time of a specific occurrence of a recurring appointment.

For example, you can easily reschedule or delete an appointment from the series that occurs on a holiday.

To do so, we have to create recurrence exception appointments using the RecurrenceExceptionDates property in the ScheduleAppointment class.

Refer to the following code to remove the occurrence of any appointment on specific dates.

// Creating an instance for appointment collection. 
var appointmentCollection = new ScheduleAppointmentCollection();   

// Recurrence and exception appointments.
var scheduleAppointment = new ScheduleAppointment 
{ 
  Id = 1, 
  Subject = "Daily scrum meeting",
  StartTime = new DateTime(2022, 3, 20, 11, 0, 0), 
  EndTime = new DateTime(2022, 3, 20, 12, 0, 0), 
  AppointmentBackground = new SolidColorBrush(Colors.RoyalBlue), 
  Foreground = new SolidColorBrush(Colors.White), 
  RecurrenceRule = "FREQ=DAILY;INTERVAL=1;COUNT=10" 
}; 

//Adding the recurring appointment to the appointmentcollection.
appointmentCollection.Add(scheduleAppointment);   

//Add the ExceptionDates to avoid occurrence on specific dates.
DateTime exceptionDate = scheduleAppointment.StartTime.AddDays(3).Date; scheduleAppointment.RecurrenceExceptionDates = new ObservableCollection&lt;DateTime&gt;() 
{ 
  exceptionDate, 
};   

//Setting appointmentCollection as ItemsSource of SfScheduler. 
Schedule.ItemsSource = appointmentCollection;
Enter fullscreen mode Exit fullscreen mode

Removing an Appointment with a Recurrence Exception in WPF Scheduler

Removing an Appointment with a Recurrence Exception in WPF Scheduler

Refer to the following code to reschedule recurring appointments.

// Creating an instance for appointment collection.
var appointmentCollection = new ScheduleAppointmentCollection();

// Recurrence and exception appointment.
var scheduleAppointment = new ScheduleAppointment
{
   Id = 1,
   Subject = "Daily scrum meeting",
   StartTime = new DateTime(2022, 3, 20, 11, 0, 0),
   EndTime = new DateTime(2022, 3, 20, 12, 0, 0),
   AppointmentBackground = new SolidColorBrush(Colors.RoyalBlue),
   Foreground = new SolidColorBrush(Colors.White),
   RecurrenceRule = "FREQ=DAILY;INTERVAL=1;COUNT=10"
};

//Adding the recurring appointment to the appointmentCollection.
appointmentCollection.Add(scheduleAppointment);

//Add ExceptionDates to avoid occurrence on specific dates.
DateTime changedExceptionDate = scheduleAppointment.StartTime.AddDays(3).Date;
scheduleAppointment.RecurrenceExceptionDates = new ObservableCollection&lt;DateTime&gt;()
{
   changedExceptionDate,
};

//Creating an exception occurrence appointment by changing the start time or end time. 

// RecurrenceId is set to 1, so it will change the occurrence for the above-created pattern appointment. 
var exceptionAppointment = new ScheduleAppointment()
{
  Id = 2,
  Subject = "Scrum meeting - Changed Occurrence",
  StartTime = new DateTime(changedExceptionDate.Year, changedExceptionDate.Month, changedExceptionDate.Day, 13, 0, 0),
  EndTime = new DateTime(changedExceptionDate.Year, changedExceptionDate.Month, changedExceptionDate.Day, 14, 0, 0),
  AppointmentBackground = new SolidColorBrush(Colors.DeepPink),
  Foreground = new SolidColorBrush(Colors.White),
  RecurrenceId = 1
};

// Adding an exception occurrence appointment to the appointmentCollection.
appointmentCollection.Add(exceptionAppointment);

//Setting the appointmentCollection as a ItemsSource of SfScheduler.
Schedule.ItemsSource = appointmentCollection;
Enter fullscreen mode Exit fullscreen mode

Removing an Appointment with a Recurrence Exception in WPF Scheduler

Removing an Appointment with a Recurrence Exception in WPF Scheduler

Note: To learn more, refer to the recursive exception appointments demo on GitHub.

Recurrence editor

Also, you can easily edit or delete a single or series of recurring appointments using the recurrence editor in the WPF Scheduler.

The following window will appear when we double-click on any recurring appointment to edit it.

Editing Recurring Appointments in WPF Scheduler

Editing Recurring Appointments in WPF Scheduler

The following window will appear when we delete a recurring appointment using the Delete key.

Deleting Recurring Appointments in WPF Scheduler

Deleting Recurring Appointments in WPF Scheduler

Conclusion

Thanks for reading! In this blog, we have seen how to easily create, edit, reschedule, and delete recurring appointments using the WPF Scheduler. Try out the steps provided in this blog post and enjoy hassle-free scheduling!

To find detailed explanations of each feature in the Scheduler control with code examples, refer to this documentation.

Please feel free to share your feedback or ask questions in the comments section below. You can also contact us through our support forum, support portal, or feedback portal. We are happy to assist you!

Related blogs

Image
14 Smart Ways To Spend The Remaining Accident Lawyer Philadelphia Budget
Image
games slots online microgaming yang harus dicoba
Image
How To Make An Amazing Instagram Video About Accident Attorneys
Image
20 Resources That Will Make You More Efficient At Bi Fold Door Repair
Image
Are Car Keys Repairs Really As Vital As Everyone Says?
Image
The Top Reasons Why People Succeed On The Local Accident Attorney Industry
Image
Cat Flaps For French Doors
Image
Congrats to the Wix Studio Challenge: Community Edition Winner!

devchallenge, wixstudiochallenge, webdev, javascript
Image
I Got Tired of Re-Explaining My Code to ChatGPT, So I Built Codura

ai, saas, chatgpt, tooling
Image
slots online termashyur untuk dipermainkan di fitur mobile
Image
What Is Accident Lawyer Portland And Why Is Everyone Talking About It?
Image
10 Bifold Repairs Near Me That Are Unexpected
Image
Installing a upvc Door Panel Cat Flap
Image
Sapi yang ga mikir akan kemaslahatan dirinya

javascript, beginners, productivity, node
Image
berikut ini arti utama di perjudian slots online
Image
mengapa slots online dapat dipercaya punyai link preferensi?
Image
Article_NOSQL Databases Cassandra - Corrales
Image
History Of Bifold Door Repair Near Me: The History Of Bifold Door Repair Near Me
Image
Can't run python script from terminal but can from PyCharm: ModuleNotFoundError

python, terminal
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .