[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
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
   [Expand]Getting Started
    Time Regions
   [Expand]Visual Elements
   [Expand]Styles and Templates
   [Expand]Design-Time Features
    Time Zones
   [Expand]Data Binding
    Appearance Customization
    Clipboard Operations
    Printing Templates
    Drag and Drop Customization
    End-User Restrictions
    Migration Guidelines
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [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
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)


Expanded Overview

Resources are entities associated with appointments. Resources ResourceItem class instances and they allow end-users to group and sort appointments. A scheduler resources' collection is available using the SchedulerControl.ResourceItems property.

Resources can be stored in the data source. To use them in a scheduler, bind a data source to the DataSource.ResourcesSource property and specify the DataSource.ResourceMappings. The DataSource.ResourceMappings property can be set to either a collection of resource IDs or a string in the XML format.

Expanded Resource Sharing

Resource sharing means that an appointment is associated with several resources. To enable resource sharing, set the DataSource.ResourceSharing property to true. Resources can be:


If an appointment doesn't belong to any particular resource (the SchedulerItemBase.ResourceId property is set to the EmptyResourceId), it is considered assigned to all resources. Hence, this appointment is shown for all resources.

Expanded Grouping by Resources

A resource becomes visible in the scheduler grouped by either resources (the SchedulerControl.GroupType is set to the SchedulerGroupType.Resource value ) or dates (the SchedulerControl.GroupType is set to the SchedulerGroupType.Date value).


If the ResourceItem.Visible property of any resource is set to false, and the scheduler is grouped by resources or dates, all appointments that belong to this resource are hidden.

The following images demonstrate the Day View when appointments are grouped by a resource...

... and a date:

In the grouped Timeline View, resources are shown vertically on the left.

The Resource Navigator control is automatically displayed in the scheduler's bottom right corner when grouping is enabled. The control allows end-users to scroll through resources and change the number of resources shown on the screen at once.

Use each View's SchedulerViewBase.ResourcesPerPage property to specify the number of resources it shows on a screen.

Expanded Member Table

Member Description
SchedulerControl.ResourceItems Provides access to the collection of resources for appointments.
SchedulerControl.VisibleResources Provides access to the collection of currently visible resources.
SchedulerControl.SelectedResource Gets or sets the resource currently selected in the scheduler.
SchedulerControl.SelectedResourceSource Gets or sets the source object for the selected resource.
SchedulerControl.GetResourceItemBySourceObject Returns a resource associated with the specified source object.

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