DxSchedulerDataStorage.RecurrenceSettings Property

Specifies common settings for recurrent appointments.

Namespace: DevExpress.Blazor

Assembly: DevExpress.Blazor.v20.2.dll

NuGet Package: DevExpress.Blazor

Declaration

public DxSchedulerRecurrenceSettings RecurrenceSettings { get; set; }

Property Value

Type	Description
DxSchedulerRecurrenceSettings	A DxSchedulerRecurrenceSettings object that contains information on recurrent appointments’ settings.

Remarks

Use the RecurrenceSettings property to specify common settings for all recurrent appointments. To change settings of an individual recurrent appointment, use properties of the DxSchedulerRecurrenceInfo object.

The code below demonstrates how to specify an occurrence count for recurrent appointments. The Meeting 1 and Meeting 2 appointments occur 3 times (the RecurrenceSettings.OccurrenceCount property is applied). The Meeting 3 appointment occurs 10 times (the DxSchedulerRecurrenceInfo.OccurrenceCount property is applied).

Index.razor

@using Data

<DxScheduler StartDate="@DateTime.Today" DataStorage="@DataStorage">
    <DxSchedulerWeekView ShowWorkTimeOnly="true" />
</DxScheduler>

@code {
    DxSchedulerDataStorage DataStorage = new DxSchedulerDataStorage() {
        RecurrenceSettings = new DxSchedulerRecurrenceSettings {
            OccurrenceCount = 3
        },
        AppointmentsSource = RecurrentAppointmentCollection.GetAppointments(),
        AppointmentMappings = new DxSchedulerAppointmentMappings() {
            Type = "AppointmentType",
            Start = "StartDate",
            End = "EndDate",
            Subject = "Caption",
            AllDay = "AllDay",
            Location = "Location",
            Description = "Description",
            LabelId = "Label",
            StatusId = "Status",
            RecurrenceInfo = "Recurrence"
        }
    };
}

Appointment.cs

using System;

namespace Scheduler.Data
{
    public class Appointment {
        public Appointment() { }

        public int AppointmentType { get; set; }
        public DateTime StartDate { get; set; }
        public DateTime EndDate { get; set; }
        public string Caption { get; set; }
        public string Description { get; set; }
        public string Location { get; set; }
        public int Label { get; set; }
        public int Status { get; set; }
        public bool AllDay { get; set; }
        public string Recurrence { get; set; }
    }
}

RecurrentAppointmentCollection.cs

using System;
using System.Collections.Generic;
using System.Globalization;

namespace Scheduler.Data {
    public static partial class RecurrentAppointmentCollection {
        public static List<Appointment> GetAppointments() {
            DateTime date = DateTime.Today;
            var dataSource = new List<Appointment>() {
               new Appointment {
                   AppointmentType = 1,
                   Caption = "Meeting 1",
                   StartDate = date + (new TimeSpan(0, 9, 00, 0)),
                   EndDate = date + (new TimeSpan(0, 10, 00, 0)),
                   Label = 5,
                   Status = 4,
                   Recurrence = string.Format("<RecurrenceInfo Type=\"0\" Start=\"{0}\" Range=\"1\" Frequency =\"1\" Id=\"cd9da802-d166-47d1-a8df-1101fcc50d53\"/>", ToString(date + (new TimeSpan(0, 9, 00, 0))))
               },
               new Appointment {
                   AppointmentType = 1,
                   Caption = "Meeting 2",
                   StartDate = date + (new TimeSpan(1, 12, 00, 0)),
                   EndDate = date + (new TimeSpan(1, 13, 00, 0)),
                   Label = 8,
                   Status = 2,
                   Recurrence = string.Format("<RecurrenceInfo Type=\"0\" Start=\"{0}\" Range=\"1\" Frequency =\"1\" Id=\"15129fd3-9eb0-4861-8c43-c61844137f17\"/>", ToString(date + (new TimeSpan(1, 12, 00, 0))))
               },
               new Appointment {
                   AppointmentType = 1,
                   Caption = "Meeting 3",
                   StartDate = date + (new TimeSpan(0, 15, 00, 0)),
                   EndDate = date + (new TimeSpan(0, 16, 00, 0)),
                   Label = 10,
                   Status = 1,
                   Recurrence = string.Format("<RecurrenceInfo Type=\"0\" Start=\"{0}\" Range=\"1\" OccurrenceCount=\"10\" Frequency =\"1\" Id=\"72e3db8f-cdb6-4aaa-afe1-e3c6b80ce995\"/>", ToString(date + (new TimeSpan(0, 15, 00, 0))))
               }
           };
            return dataSource;
        }

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