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.v23.2.dll

NuGet Package: DevExpress.Win.Scheduler

Declaration

C#

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

VB.NET

Public Function CreateAppointment(
    type As AppointmentType,
    start As Date,
    duration As TimeSpan,
    subject As String
) As Appointment

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.

C#

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();

VB.NET

Dim count As Integer = 10
Dim AppArray(count - 1) As Appointment
Dim AppCollection As New AppointmentCollection()
For i As Integer = 1 To count
    Dim newApp As Appointment = schedulerControl.DataStorage.CreateAppointment(AppointmentType.Normal)
    newApp.Start = Date.Now.AddMinutes(count)
    newApp.End = Date.Now.AddMinutes(count * 2)
    AppCollection.Add(newApp)
Next i
AppCollection.CopyTo(AppArray, 0)
schedulerControl.DataStorage.BeginUpdate()
schedulerControl.DataStorage.Appointments.AddRange(AppArray)
schedulerControl.DataStorage.EndUpdate()

Related GitHub Examples

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.

C#

winforms-scheduler-formatting-services/CS/FormattingServicesExample/Data/Data.cs#L59

Appointment CreateMeeting(string subject, DateTime date, int[] participants) {
    Appointment apt = schedulerStorage1.CreateAppointment(AppointmentType.Normal, date, TimeSpan.FromHours(1), subject);
    string description = "The following persons are invited:\r\n";

VB.NET

winforms-scheduler-formatting-services/VB/FormattingServicesExample/Data/Data.vb#L51

Private Function CreateMeeting(ByVal subject As String, ByVal [date] As Date, ByVal participants As Integer()) As Appointment
    Dim apt As Appointment = schedulerStorage1.CreateAppointment(AppointmentType.Normal, [date], TimeSpan.FromHours(1), subject)
    Dim description As String = "The following persons are invited:" & Microsoft.VisualBasic.Constants.vbCrLf