[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].NET Core 3 Support
 [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
  [Collapse]Scheduler
   [Expand]Getting Started
   [Expand]Appointments
    Resources
    Reminders
   [Expand]Views
   [Expand]Visual Elements
   [Expand]Styles and Templates
   [Expand]Design-Time Features
    Time Zones
   [Collapse]Data Binding
     Mappings
     Mapping Converters
     Custom Fields
    Appearance Customization
    Grouping
    Selecting
    Clipboard Operations
    Printing Templates
    Drag and Drop Customization
    Navigating
    Printing
    End-User Restrictions
   [Expand]Examples
    Migration Guidelines
  [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
  [Expand]Scheduler (legacy)
 [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)

Mappings

Expanded Overview

When you bind the Scheduler to a data source, you need to map Appointments, Resources, Labels and Statuses properties to data source fields. The names of the database fields are usually fixed, and you cannot change them. Mappings are used to adjust the Scheduler data model to the existing data model.

The SchedulerControl uses Mapping instances to connect the object properties with the corresponding data fields. Use the Mapping.Converter property to register a value converter for a custom storage format. Review the Mapping Converters topic for more information.

You can define Custom Mappings - any number of mappings to data source fields that are not used by the Scheduler itself. The content of these fields is available using the SourceObjectContainer.CustomFields property of the AppointmentItem, ResourceItem, AppointmentLabelItem and AppointmentStatusItem objects. To specify a custom mapping, create a CustomFieldMapping instance and add it to the MappingsBase.CustomFieldMappings collection. To learn more, see the Custom Fields document.

Expanded Appointment Mappings

Mapping Description
AppointmentMappings.AllDay Specifies the mapping that binds the appointment's AppointmentItem.AllDay property to the data source field.
AppointmentMappings.Description Specifies the mapping that binds the appointment's AppointmentItem.Description property to the data source field.
AppointmentMappings.End (required mapping) Specifies the mapping that binds the appointment's AppointmentItem.End property to the data source field.
AppointmentMappings.Id Gets or sets the mapping that binds the appointment's SourceObjectContainer.Id property to the data source field.
AppointmentMappings.Location Specifies the mapping that binds the appointment's AppointmentItem.Location property to the data source field.
AppointmentMappings.LabelId Specifies the mapping that binds the appointment's AppointmentItem.LabelId property to the data source field.
AppointmentMappings.QueryStart Specifies the mapping that binds the appointment's AppointmentItem.QueryStart property to the data source field.
AppointmentMappings.QueryEnd Specifies the mapping that binds the appointment's AppointmentItem.QueryEnd property to the data source field.
AppointmentMappings.RecurrenceInfo (required mapping for recurring appointments) Gets or sets the mapping that binds the appointment's AppointmentItem.RecurrenceInfo property to the data source field.
AppointmentMappings.Reminder Gets or sets the mapping that binds the appointment's AppointmentItem.Reminder property to the data source field.
AppointmentMappings.ResourceId Specifies the mapping that binds the appointment's AppointmentItem.ResourceId and AppointmentItem.ResourceIds properties to the data source field.
AppointmentMappings.Start (required mapping) Specifies the mapping that binds the appointment's AppointmentItem.Start property to the data source field.
AppointmentMappings.StatusId Gets or sets the mapping that binds the appointment's AppointmentItem.StatusId property to the data source field.
AppointmentMappings.Subject Specifies the mapping that binds the appointment's AppointmentItem.Subject property to the data source field.
AppointmentMappings.TimeZoneId Specifies the mapping that binds the appointment's AppointmentItem.TimeZoneId propertyto the data source field.
AppointmentMappings.Type (required mapping for recurring appointments) Gets or sets the mapping that binds the appointment's AppointmentItem.Type property to the data source field.

Expanded Appointment Label Mappings

Mapping Description
AppointmentLabelMappings.Caption Gets or sets the mapping that binds the appointment label's AppointmentLabelItem.Caption property to the data source.
AppointmentLabelMappings.Color Gets or sets the mapping that binds the appointment label's AppointmentLabelItem.Color property to the data source field.
AppointmentLabelMappings.Id Gets or sets the mapping that binds the appointment label's SourceObjectContainer.Id property to the data source.

Expanded Appointment Status Mappings

Mapping Description
AppointmentStatusMappings.Id Specifies the mapping that binds the appointment status's SourceObjectContainer.Id property to the data source field.
AppointmentStatusMappings.Caption Specifies the mapping that binds the appointment status's AppointmentStatusItem.Caption property to the data source field.
AppointmentStatusMappings.Brush Specifies the mapping that binds the appointment label's AppointmentStatusItem.Brush property to the data source field.

Expanded Resource Mappings

Mapping Description
ResourceMappings.Caption Specifies the mapping that binds the resource's ResourceItem.Caption property to the data source field.
ResourceMappings.Color Specifies the mapping that binds the resource's ResourceItem.Color property to the data source field.
ResourceMappings.Id Specifies the mapping that binds the resource's SourceObjectContainer.Id property to the data source field.
ResourceMappings.Visible Gets or sets the mapping that binds the appointment's ResourceItem.Visible property to the data source field.

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