SchedulerExtension.GetAppointmentsToInsert<T>(String, FirstDayOfWeek, FetchAppointmentsMethod, Object, MVCxAppointmentStorage, MVCxResourceStorage) Method

Obtains appointments which should be inserted into the data source.

Namespace: DevExpress.Web.Mvc

Assembly: DevExpress.Web.Mvc5.v24.1.dll

NuGet Package: DevExpress.Web.Mvc5

Declaration

C#

public static T[] GetAppointmentsToInsert<T>(
    string schedulerName,
    FirstDayOfWeek firstDayOfWeek,
    FetchAppointmentsMethod fetchAppointmentsMethod,
    object resourceDataObject,
    MVCxAppointmentStorage appointmentStorage,
    MVCxResourceStorage resourceStorage
)

VB.NET

Public Shared Function GetAppointmentsToInsert(Of T)(
    schedulerName As String,
    firstDayOfWeek As FirstDayOfWeek,
    fetchAppointmentsMethod As FetchAppointmentsMethod,
    resourceDataObject As Object,
    appointmentStorage As MVCxAppointmentStorage,
    resourceStorage As MVCxResourceStorage
) As T()

Parameters

Name	Type	Description
schedulerName	String	The name of a Scheduler as specified by the SettingsBase.Name property.
firstDayOfWeek	FirstDayOfWeek	A FirstDayOfWeek enumeration value specifying the first day of the week.
fetchAppointmentsMethod	FetchAppointmentsMethod	A FetchAppointmentsMethod delegate that provides appointments to insert.
resourceDataObject	Object	A collection of resources in the scheduler.
appointmentStorage	MVCxAppointmentStorage	An MVCxAppointmentStorage object that implements the appointment storage functionality and contains mappings.
resourceStorage	MVCxResourceStorage	An MVCxResourceStorage object that implements the resource storage functionality and contains mappings.

Type Parameters

Name
T

Returns

Type	Description
T[]	A Model data class instance that is the entity contained in the appointment data source and mapped to an appointment.

Remarks

The GetAppointmentsToInsert<T> method creates a fake Scheduler but does not apply all scheduler settings specified in the view, for better performance. Then, an appointment being inserted is retrieved from this Scheduler instance.

Utilizing the GetAppointmentsToInsert<T> method allows you to handle recurring appointments correctly. Now, when an end-user selects and moves multiple recurring appointments at the same time, the corresponding number of database records will be created. For example, if two recurring appointments are moved simultaneously, two records will appear in the database.

For an example of use, refer to the following code snippet.

View Example: Scheduler - How to implement the FetchAppointment event functionality

SchedulerPartial.cshtml

@Html.DevExpress().Scheduler(SchedulerSettingsHelper.CommonSchedulerSettings).Bind(Model.FetchAppointments, Model.Resources).GetHtml()

HomeController.cs

static void UpdateAppointment() {

    DBAppointment[] insertedAppt = SchedulerExtension.GetAppointmentsToInsert<DBAppointment>(SchedulerSettingsHelper.CommonSchedulerSettings,
        SchedulerDataHelper.FetchAppointmentsHelperMethod,
        SchedulerDataHelper.GetResources());
    foreach (var appt in insertedAppt) {
        SchedulerDataHelper.InsertAppointment(appt);
    }

    DBAppointment[] updatedAppt = SchedulerExtension.GetAppointmentsToUpdate<DBAppointment>(SchedulerSettingsHelper.CommonSchedulerSettings,
        SchedulerDataHelper.FetchAppointmentsHelperMethod,
        SchedulerDataHelper.GetResources());

    foreach (var appt in updatedAppt) {
        SchedulerDataHelper.UpdateAppointment(appt);
    }

    DBAppointment[] removedAppt = SchedulerExtension.GetAppointmentsToRemove<DBAppointment>(SchedulerSettingsHelper.CommonSchedulerSettings,
        SchedulerDataHelper.FetchAppointmentsHelperMethod, 
        SchedulerDataHelper.GetResources());
    foreach (var appt in removedAppt) {
        SchedulerDataHelper.RemoveAppointment(appt);
    }

}

HomeController.vb

Private Shared Sub UpdateAppointment()

    Dim insertedAppt() As DBAppointment = SchedulerExtension.GetAppointmentsToInsert(Of DBAppointment)(SchedulerSettingsHelper.CommonSchedulerSettings, AddressOf SchedulerDataHelper.FetchAppointmentsHelperMethod, SchedulerDataHelper.GetResources())
    For Each appt In insertedAppt
        SchedulerDataHelper.InsertAppointment(appt)
    Next appt

    Dim updatedAppt() As DBAppointment = SchedulerExtension.GetAppointmentsToUpdate(Of DBAppointment)(SchedulerSettingsHelper.CommonSchedulerSettings, AddressOf SchedulerDataHelper.FetchAppointmentsHelperMethod, SchedulerDataHelper.GetResources())

    For Each appt In updatedAppt
        SchedulerDataHelper.UpdateAppointment(appt)
    Next appt

    Dim removedAppt() As DBAppointment = SchedulerExtension.GetAppointmentsToRemove(Of DBAppointment)(SchedulerSettingsHelper.CommonSchedulerSettings, AddressOf SchedulerDataHelper.FetchAppointmentsHelperMethod, SchedulerDataHelper.GetResources())
    For Each appt In removedAppt
        SchedulerDataHelper.RemoveAppointment(appt)
    Next appt

End Sub