SchedulerStorage.CreateAppointment(AppointmentType) Method

Creates an appointment of the specified type.

Namespace: DevExpress.Xpf.Scheduler

Assembly: DevExpress.Xpf.Scheduler.v18.2.dll

Declaration

C#

public Appointment CreateAppointment(
    AppointmentType type
)

VB.NET

Public Function CreateAppointment(
    type As AppointmentType
) As Appointment

Parameters

Name	Type	Description
type	AppointmentType	An AppointmentType enumeration value specifying the type of the created appointment.

Returns

Type	Description
Appointment	A newly created Appointment object.

Remarks

Important

You are viewing documentation for the legacy WPF Scheduler control. If you’re starting a new project, we strongly recommend that you use a new control declared in the DevExpress.Xpf.Scheduling namespace. If you decide to upgrade an existing project in order to switch to the updated scheduler control, see the Migration Guidelines document.

The method employs the Appointment Factory (accessible with the AppointmentStorageBase.AppointmentFactory property) to create an appointment.

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 AppointmentStorage.Add method to add a newly created appointment to the storage.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the CreateAppointment(AppointmentType) 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#

how-to-apply-a-custom-template-to-appointments-in-day-or-work-week-view-e3008/CS/WpfApplication1/MainWindow.xaml.cs#L12

SchedulerStorage schedulerStorage = schedulerControl1.Storage;
Appointment apt = schedulerStorage.CreateAppointment(AppointmentType.Normal);
DateTime baseTime = DateTime.Today;

how-to-display-a-custom-field-value-in-a-custom-appointment-template-e4681/CS/MainWindow.xaml.cs#L13

schedulerStorage.AppointmentStorage.CustomFieldMappings.Add(new SchedulerCustomFieldMapping("cfPrice", "Price"));
Appointment apt = schedulerStorage.CreateAppointment(AppointmentType.Normal);
apt.CustomFields["cfPrice"] = 10;

how-to-handle-key-press-events-in-the-schedulercontrol-e2906/CS/DXScheduler_KeyHandling/MyKeyboardHandlerService.cs#L28

SchedulerControl scheduler = (SchedulerControl)_provider;
Appointment apt = scheduler.Storage.CreateAppointment(AppointmentType.Normal);
apt.Subject = "Test";

how-to-completely-customize-appointment-styles-e4412/CS/SchedulerCompleteAppointmentStyleWpf/MainWindow.xaml.cs#L12

SchedulerStorage schedulerStorage = schedulerControl1.Storage;
Appointment apt = schedulerStorage.CreateAppointment(AppointmentType.Normal);
DateTime baseTime = DateTime.Today;

wpf-schedulercontrol-api-t442105/CS/SchedulerControl_WPF_API/CodeExamples/AppointmentExamples.cs#L17

// Create a new appointment.
Appointment apt = scheduler.Storage.CreateAppointment(AppointmentType.Normal);

VB.NET

how-to-apply-a-custom-template-to-appointments-in-day-or-work-week-view-e3008/VB/WpfApplication1/MainWindow.xaml.vb#L14

Dim schedulerStorage As SchedulerStorage = schedulerControl1.Storage
Dim apt As Appointment = schedulerStorage.CreateAppointment(AppointmentType.Normal)
Dim baseTime As DateTime = DateTime.Today

how-to-display-a-custom-field-value-in-a-custom-appointment-template-e4681/VB/MainWindow.xaml.vb#L15

schedulerStorage.AppointmentStorage.CustomFieldMappings.Add(New SchedulerCustomFieldMapping("cfPrice", "Price"))
Dim apt As Appointment = schedulerStorage.CreateAppointment(AppointmentType.Normal)
apt.CustomFields("cfPrice") = 10

how-to-handle-key-press-events-in-the-schedulercontrol-e2906/VB/DXScheduler_KeyHandling/MyKeyboardHandlerService.vb#L26

Dim scheduler As SchedulerControl = CType(_provider, SchedulerControl)
Dim apt As Appointment = scheduler.Storage.CreateAppointment(AppointmentType.Normal)
apt.Subject = "Test"

how-to-completely-customize-appointment-styles-e4412/VB/SchedulerCompleteAppointmentStyleWpf/MainWindow.xaml.vb#L14

Dim schedulerStorage As SchedulerStorage = schedulerControl1.Storage
Dim apt As Appointment = schedulerStorage.CreateAppointment(AppointmentType.Normal)
Dim baseTime As Date = Date.Today

wpf-schedulercontrol-api-t442105/VB/SchedulerControl_WPF_API/CodeExamples/AppointmentExamples.vb#L17

' Create a new appointment.
Dim apt As Appointment = scheduler.Storage.CreateAppointment(AppointmentType.Normal)