[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
    Time Regions
   [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)

Data Binding

The scheduler operates with appointments, time regions, and resources. These objects may persist if the scheduler is bound to data. The scheduler can operate in bound and unbound mode.

Expanded Unbound Mode

If you do not bind a data source to the SchedulerControl component, it maintains appointments and resources internally. To manage Scheduler items in code, access the corresponding collections using the properties listed in the following table:

Item Property
Appointment SchedulerControl.AppointmentItems
Resource SchedulerControl.ResourceItems
Label SchedulerControl.LabelItems
Status SchedulerControl.StatusItems
Time Region SchedulerControl.TimeRegionItems

Expanded Bound Mode

To use the Scheduler in the data-bound mode, specify bindings to external data sources and define Mappings which map data fields to corresponding properties of the Scheduler's items. Mappings are different if an appointment has a single associated resource or several resources (shared resources).

Review the First Lesson - Create a Simple Scheduling Application topic for a basic example of the data-bound scheduler.

Important

Each binding requires a corresponding mapping to work.

Tip

You can operate in a mixed mode, with appointments contained in the external data source or MVVM data model and bound to the DataSource.AppointmentsSource property, and labels, statuses or resources created in code or XAML added to the respective collections.

The following table lists properties specific to data binding:

Member Description
DataSource An object that specifies data sources and mappings for the Scheduler objects.
DataSource.AppointmentsSource Gets or sets a collection of objects containing appointment information. This is a dependency property.
DataSource.ResourcesSource Gets or sets a collection of objects containing resource information. This is a dependency property.
DataSource.AppointmentLabelsSource Gets or sets a collection of objects containing appointment label (category) information. This is a dependency property.
DataSource.AppointmentStatusesSource Gets or sets a collection of objects containing appointment status information. This is a dependency property.
DataSource.TimeRegionsSource Gets or sets a collection of objects containing time region information. This is a dependency property.
AppointmentMappings Provides information on the appointment properties' mapping to data fields.
ResourceMappings Provides information on the resource properties' mapping to data fields.
AppointmentLabelMappings Provides information on the appointment label properties' mapping to data fields.
AppointmentStatusMappings Provides information on the appointment status properties' mapping to data fields.
TimeRegionMappings Provides information on the time region properties' mapping to data fields.
CustomFieldMapping Provides information on custom property mapping to appropriate data fields.
SchedulerControl.AppointmentsUpdated Occurs after Scheduler appointments are updated.
DataSource.ResourceSharing Gets or sets a value indicating whether an appointment can be shared between multiple resources. This is a dependency property.
AppointmentResourceIdCollectionXmlPersistenceHelper Provides methods to load resource ID's from XML and export them in the same format they are stored in the bound data source.

Expanded See Also

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