DxSchedulerRecurrenceInfo Class

Contains recurrence information about an appointment.

Namespace: DevExpress.Blazor

Assembly: DevExpress.Blazor.v24.1.dll

NuGet Package: DevExpress.Blazor

Declaration

public class DxSchedulerRecurrenceInfo :
    DxSchedulerSourceObjectContainer,
    ISchedulerRecurrenceInfo,
    INotifyPropertyChanged

Remarks

The DxSchedulerRecurrenceInfo class properties define an appointment’s recurrence rule.

When you bind the Scheduler control to a collection of data objects, the recurrent appointment object should contain the following fields:

• A field that sets the appointment’s type to 1 (corresponds to the Pattern value). Use the Type property to map this field to the appointment’s property.
• A field that specifies the recurrence rule. Use the RecurrenceInfo property to map this field to the appointment’s property.

Recurrence Rule

A recurrence rule is a string that starts with the RecurrenceInfo prefix and specifies options that correspond to the DxSchedulerRecurrenceInfo members. The following example demonstrates a sample field value in the correct notation.

"<RecurrenceInfo Id=\"15129fd3-9eb0-4861-8c43-c61844137f17\" Start=\"{0}\" Range=\"0\" 
                Type=\"3\" Frequency=\"1\" Month = \"4\" WeekOfMonth=\"5\" WeekDays=\"2\" />"

To create a recurrence rule, specify the following properties:

Id

Identifies the recurrence rule and allows the control to create a series based on the rule. Example: Id="bd5dc726-0fa6-4965"

Start

Specifies the recurrent appointment’s start date. Example: Start="04/01/2020 7:00:00"

Range

Determines how the series end date is specified: by the end date, number of occurrences, or no end date in the case of a recurrent appointment. The available values are listed below.

• 0 - The recurrence range has no end date. Example: Range="0"
• 1 - The range ends after its recurrence count exceeds OccurrenceCount. Example: Range="1" OccurrenceCount="15"
• 2 - A recurrent appointment ends after the End date. Example: Range="2" End="05/01/2020 7:00:00"

Type

Specifies the unit of time used to calculate appointment reoccurrences: day, week, month, or year.

Daily (0)

Repeat the appointment every Frequency days.
Example: Type="0" Frequency ="3" - Repeats the appointment every 3 days.

Weekly (1)

Repeat the appointment every Frequency weeks on WeekDays days.
Example: Type="1" Frequency="2" WeekDays="16" - Repeats the appointment every 2 weeks on Thursdays.

Monthly (2)

Specify by a day number
Repeat the appointment every Frequency months on DayNumber days. Set the WeekOfMonth property to 0 to specify that the week in a month does not affect the recurrence rule.
Example: Type="2" Frequency="1" WeekOfMonth="0" DayNumber="30" - Repeats the appointment on the 30th day of every month.

Specify by a week day
Repeat the appointment every Frequency months in the WeekOfMonth week on WeekDays days.
Example: Type="2" Frequency="1" WeekOfMonth="1" WeekDays="2" - Repeats the appointment on the first Monday of every month.

Yearly (3)

Specify by a day number and a month
Repeat the appointment every Frequency years in the Month month on DayNumber days. Set the WeekOfMonth property to 0 to specify that the week in a month does not affect the recurrence rule.
Example: Type="3" Frequency="1" Month="3" WeekOfMonth="0" DayNumber="5" - Repeats the appointment on the 5th of March every year.

Specify by a week day and a month
Repeat the appointment every Frequency years in the Month month in the WeekOfMonth week on WeekDays days.
Example: Type="3" Frequency="1" Month="3" WeekOfMonth="1" WeekDays="2" - Repeats the appointment on the first Monday of March every year.

Index

Used for changed and deleted occurrences only. Specifies the appointment index in the recurring series, which should be the same as DxSchedulerAppointmentItem.RecurrenceIndex. Example: Index=\"25\"

The following example creates four recurrent appointments.

Razor

 <DxScheduler StartDate="@DateTime.Today" 
              DataStorage="@DataStorage" 
              FirstDayOfWeek="System.DayOfWeek.Sunday">
    <DxSchedulerWeekView VisibleTime="@VisibleTime"></DxSchedulerWeekView>
</DxScheduler>

@code {
    DxSchedulerTimeSpanRange VisibleTime = new DxSchedulerTimeSpanRange(TimeSpan.FromHours(8), 
          TimeSpan.FromHours(19));

    DxSchedulerDataStorage DataStorage = new DxSchedulerDataStorage() {
        AppointmentsSource = RecurringAppointmentCollection.GetAppointments(),
        AppointmentMappings = new DxSchedulerAppointmentMappings() {
            Type = "AppointmentType",
            Start = "StartDate",
            End = "EndDate",
            Subject = "Caption",
            LabelId = "Label",
            RecurrenceInfo = "Recurrence"
        }
    };
}

RecurringAppointment

public class RecurringAppointment {
    public RecurringAppointment() {}

    public int AppointmentType { get; set; }
    public DateTime StartDate { get; set; }
    public DateTime EndDate { get; set; }
    public string Caption { get; set; }
    public int Label { get; set; }
    public string Recurrence { get; set; }
}

RecurringAppointmentCollection

public static partial class RecurringAppointmentCollection {
    public static List<RecurringAppointment> GetAppointments() {
        DateTime date = new DateTime(2020, 4, 26);
        return new List<RecurringAppointment>() {             
            new RecurringAppointment {
                AppointmentType = 1,
                Caption = "Meeting on Daily Basis",
                Label = 5,
                StartDate = date + (new TimeSpan(0, 9, 30, 0)),
                EndDate = date + (new TimeSpan(0, 11, 0, 0)),
                // Meeting on Daily Basis: repeats every 3 days (15 times).
                Recurrence = string.Format("<RecurrenceInfo Type=\"0\" Start=\"{0}\" Range=\"1\" 
                  OccurrenceCount=\"15\"  Frequency =\"3\" Id=\"72e3db8f-cdb6-4aaa-afe1-e3c6b80ce995\"/>", 
                  ToString(date + (new TimeSpan(0, 9, 30, 0))))
            },
            new RecurringAppointment {
                AppointmentType = 1,
                Caption = "Meeting on Weekly Basis",
                Label = 2,
                StartDate = date + (new TimeSpan(0, 10, 0, 0)),
                EndDate = date + (new TimeSpan(0, 12, 0, 0)),
                // Meeting on Weekly Basis: repeats every 2 weeks on Thursday for 90 days.
                Recurrence = string.Format("<RecurrenceInfo Type=\"1\" Start=\"{0}\" Range=\"2\"  End=\"{1}\" 
                  Frequency =\"2\" WeekDays=\"16\" Id=\"bd5dc726-0fa6-4965-99e0-bf6906321855\"/>", 
                  ToString(date + (new TimeSpan(0, 10, 0, 0))), 
                  ToString(date + (new TimeSpan(90, 0, 0, 0))))
            },
            new RecurringAppointment {
                AppointmentType = 1,
                Caption = "Meeting on Monthly Basis",
                Label = 6,
                StartDate = date + (new TimeSpan(0, 12, 0, 0)),
                EndDate = date + (new TimeSpan(0, 15, 0, 0)),
                // Meeting on Monthly Basis: repeats on the 30th day of each month and has no end date.
                Recurrence = string.Format("<RecurrenceInfo Type=\"2\" Start=\"{0}\" Range=\"0\"  
                  Frequency=\"1\" WeekOfMonth=\"0\" DayNumber=\"30\" 
                  Id=\"cd9da802-d166-47d1-a8df-1101fcc50d53\"/>", 
                  ToString(date + (new TimeSpan(0, 12, 0, 0))))
            },
            new RecurringAppointment {
                AppointmentType = 1,
                Caption = "Meeting on Yearly Basis",
                Label = 9,
                StartDate = date + (new TimeSpan(0, 11, 0, 0)),
                EndDate = date + (new TimeSpan(0, 13, 00, 0)),
                // Meeting on Yearly Basis: repeats on the last Monday in April every year and has no end date.
                Recurrence = string.Format("<RecurrenceInfo Type=\"3\" Start=\"{0}\" Range=\"0\" 
                  Frequency=\"1\" Month = \"4\"  WeekOfMonth=\"5\" WeekDays=\"2\" 
                  Id=\"15129fd3-9eb0-4861-8c43-c61844137f17\"/>", 
                  ToString(date + (new TimeSpan(0, 11, 0, 0))))
            }
        };
    }

    private static string ToString(DateTime dateTime) {
        return dateTime.ToString(CultureInfo.InvariantCulture);
    }
}

Run Demo: Scheduler - Recurring Appointments

Recurrence Rule for Changed and Deleted Occurrences

For changed and deleted occurrences, a recurrence rule should contain Id and Index properties:

"<RecurrenceInfo Id=\"6de79b21-6b16-4dea-9736-c500058ec858\" Index=\"25\"/>"

Implements

INotifyPropertyChanging

ISchedulerRecurrenceInfo

INotifyPropertyChanged

Inheritance

Object

DevExpress.Blazor.Scheduler.Internal.NotifyPropertyChangedBase

DxSchedulerSourceObjectContainer

DxSchedulerRecurrenceInfo