How to: Create Appointments with Various Recurrence Types Programmatically
- 2 minutes to read
This document demonstrates how to programmatically create recurring appointments with different periodicity and number of occurrences. Many examples are provided to help you specify complex periodical conditions.
Perform the following simple steps. First, create a new appointment that will serves as a pattern for recurring appointments. Then, modify its recurrence information as required via the Appointment.RecurrenceInfo property. Note than you can specify only one type of recurrence – by the minute, hourly, daily, weekly, monthly, or yearly. Finally, add the created recurrence pattern to the storage.
#1. Create a Pattern
Use the following code to create a pattern for recurring appointments starting at 9 AM and finishing at 9:15. So the first appointment in a series will start at 9 AM and will last for 15 minutes.
Appointment apt = schedulerControl1.Storage.CreateAppointment(AppointmentType.Pattern);
apt.Start = DateTime.Today.AddHours(9);
apt.End = apt.Start.AddMinutes(15);
apt.Subject = "My Subject";
apt.Location = "My Location";
apt.Description = "My Description";
#2. Specify the Recurrence Information
To specify recurrence information, use the Appointment.RecurrenceInfo property that provides access to the RecurrenceInfo instance. It is created automatically for an appointment of the AppointmentType.Pattern type.
Select one of available recurrence types and set all required recurrence attributes. For example, refer to one of the following documents.
How to: Customize Minutely Recurrence
How to: Customize Hourly Recurrence
How to: Customize Daily Recurrence
How to: Customize Weekly Recurrence
How to: Customize Monthly Recurrence
How to: Customize Yearly Recurrence
#3. The Final Step
And finally, add the created recurrence pattern to the storage.