[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
   Reporting
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Collapse]Scheduler (legacy)
   [Expand]Overview
   [Expand]Getting Started
   [Collapse]Fundamentals
    [Expand]Scheduler Elements
    [Expand]Appointments
     Resources
    [Expand]Views
     Pop-up Menus
    [Expand]Data Binding
    [Collapse]Mappings
      Appointment Mappings
      Resource Mappings
      Required Fields
      Custom Fields
      Mapping Converters
    [Expand]Supported Formats
    [Expand]Styles and Templates
     Services
     Time Zones
    [Expand]Printing
     Product Class Structure
     Scheduling Basics
   [Expand]Visual Elements
   [Expand]Examples
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Appointment Mappings

Note

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.

Mapping

Data Type

Description

AllDay

Boolean

Maps to the Appointment.AllDay property. Not required.

AppointmentId

Object (any type)

Maps to the PersistentObject.Id property. Appointment identity. Should be unique. This mapping is required for the Gantt View only to establish and maintain appointment relations. Other views, the SchedulerStorage and built-in appointment operations do not use the value of the Appointment.Id property. Therefore, if your application relies on Appointment.Id, you should provide methods for assigning the ID and updating the underlying data source with the actual ID value, as described in the PersistentObject.Id article.

Consider using the AppointmentStorage.CommitIdToDataSource and the AppointmentStorage.AutoRetrieveId properties in different identifier generation scenarios.

Description

String

Maps to the Appointment.Description property. Not required.

End

DateTime

Maps to the Appointment.End property. Required.

Label

Object (any type)

Maps to the Appointment.LabelKey property. The Label identifier. Not required.

Location

String

Maps to the Appointment.Location property. Not required.

OriginalOccurrenceStart

DateTime

Maps to the Appointment.OriginalOccurrenceStart property. Not required. Used in scenarios which handle the FetchAppointments event for recurring appointments.

OriginalOccurrenceEnd

DateTime

Maps to the Appointment.OriginalOccurrenceEnd property. Not required. Used in scenarios which handle the FetchAppointments event for recurring appointments.

PercentComplete

Integer

Maps to the Appointment.PercentComplete property. Not required. Used for the Gantt View only.

ResourceId

Object (any type)

Maps to the Appointment.ResourceId property. Required for identifying a resource for the appointment. Should be the same type as the ID Resource mapping.

ResourceIds

String

Maps to the Appointment.ResourceIds property. Required for associating multiple resources with appointments, when the SchedulerControl.ResourceSharing property is set to true. The data is composed of tags and attributes that specify the ID type and the ID value of associated resources. Starting from version 15.2 resource identifiers are of Object type so they are serialized using Base64 encoding. Set the SchedulerCompatibility.Base64XmlObjectSerialization property to false to store them as integers.

RecurrenceInfo

String

Maps to the Appointment.RecurrenceInfo property. Not required. The data is a list of attributes with values. If the appointment is the first in the chain, the data contains a unique pattern identifier, and parameters that describe the recurrence pattern. If the appointment is not the first member in a chain, the data contains a pattern identifier and the index in the chain.

ReminderInfo

String

Used to create a reminder specified by the Appointment.Reminder property. Not required. The data is a list of attributes with values. The attribute values are specified for the ReminderBase.AlertTime value and the ReminderBase.TimeBeforeStart value.

Start

DateTime

Maps to the Appointment.Start property. Required.

Status

Object (any type)

Maps to the Appointment.StatusKey property. The Status identifier. Not required.

Subject

String

Maps to the Appointment.Subject property. Not required.

TimeZoneId

String

Maps to the Appointment.TimeZoneId property. Not required. Used to store the original time zone for the appointment.

Type

Integer

Maps to the Appointment.Type property. Contains integer values that correspond to the AppointmentType enumeration. Required if the RecurrenceInfo mapping is set and the recurrence is enabled.

Is this topic helpful?​​​​​​​