Skip to main content

SchedulerDataStorage.CreateAppointment(AppointmentType, DateTime, TimeSpan, String) Method

Creates an appointment of the specified type with the specified start time, duration and subject.

Namespace: DevExpress.XtraScheduler

Assembly: DevExpress.XtraScheduler.v24.1.dll

NuGet Package: DevExpress.Win.Scheduler

Declaration

public Appointment CreateAppointment(
    AppointmentType type,
    DateTime start,
    TimeSpan duration,
    string subject
)

Parameters

Name Type Description
type AppointmentType

An AppointmentType enumeration value specifying the type of the created appointment.

start DateTime

A DateTime object specifying the appointment start - the value of the Appointment.Start property.

duration TimeSpan

A TimeSpan object specifying the appointment duration - the value of the Appointment.Duration property.

subject String

A string that is the appointment’s subject - the value of the Appointment.Subject property.

Returns

Type Description
Appointment

A newly created Appointment object.

Remarks

Use the CreateAppointment method to create an appointment of the specified type. This method also creates all the required custom fields and adds it to the appointment’s CustomFieldCollection, available via the PersistentObject.CustomFields property. To add custom fields to the appointment manually use the PersistentObjectStorage<T>.CreateCustomFields method.

Subsequently use the AppointmentDataStorage.Add method to add a newly created appointment to the storage.

The following code illustrates how to add multiple appointments in code.

int count = 10;
Appointment[] AppArray = new Appointment[count];
AppointmentCollection AppCollection = new AppointmentCollection();
for (int i=1; i<=count; i++) {
    Appointment newApp = schedulerControl.DataStorage.CreateAppointment(AppointmentType.Normal);
    newApp.Start = DateTime.Now.AddMinutes(count);
    newApp.End = DateTime.Now.AddMinutes(count * 2);
    AppCollection.Add(newApp);
}
AppCollection.CopyTo(AppArray, 0);
schedulerControl.DataStorage.BeginUpdate();
schedulerControl.DataStorage.Appointments.AddRange(AppArray);
schedulerControl.DataStorage.EndUpdate();

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the CreateAppointment(AppointmentType, DateTime, TimeSpan, String) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

See Also