SchedulerDataStorage Component
- 2 minutes to read
#What is the Scheduler Data Storage?
The SchedulerDataStorage is a stand-alone component that loads all Scheduler data (appointments, resources, appointment dependencies, statuses, and labels) from external data sources. This component is automatically added when you drop a SchedulerControl onto the form, but you can add more storages from the Visual Studio toolbox.
Use the SchedulerControl.DataStorage property to assign the storage to a Scheduler.
#Data Binding
This storage uses the following collections to store data retrieved from external sources:
- SchedulerDataStorage.Appointments
- SchedulerDataStorage.Resources
- SchedulerDataStorage.AppointmentDependencies
- SchedulerDataStorage.Statuses
- SchedulerDataStorage.Labels
You can use the SchedulerControl‘s or the storage’s smart tags to bind these collections to data sources. See the Data Binding and Getting Started articles for the details.
#Data Exchange
In addition to direct data binding, you can import and export the storage data to/from Microsoft Outlook, iCalendars and vCalendars (ver. 1.0) using the following methods:
Import data
- SchedulerDataStorage.ImportFromOutlook
- SchedulerDataStorage.ImportFromICalendar
- SchedulerDataStorage.ImportFromVCalendar
- SchedulerDataStorage.SynchronizeStorageWithOutlook
Export data
- SchedulerDataStorage.ExportToOutlook
- SchedulerDataStorage.ExportToICalendar
- SchedulerDataStorage.ExportToVCalendar
- SchedulerDataStorage.SynchronizeOutlookWithStorage
#Mappings
You need to map source data fields to the required object properties after the storage collection (for example, the SchedulerDataStorage.Appointments) receives a data source using the Scheduler’s wizards. They can analyze the available data fields and map them automatically.
Refer to the Mappings article to learn more.
#Storage Events
Modifying storage data raises the following events that allow you to perform additional actions and\or cancel these changes:
Member Name | Description |
---|---|
Scheduler |
Fires when a new appointment is about to be added to the persistent storage. |
Scheduler |
Occurs after a new appointment is added to the persistent storage. |
Scheduler |
Fires when an appointment is about to be modified. |
Scheduler |
Occurs when appointments have been changed. |
Scheduler |
Fires when the appointment is about to be deleted. |
Scheduler |
Occurs when appointments have been deleted. |
Scheduler |
Allows you to cancel the addition of a resource. |
Scheduler |
Occurs when new resources are inserted into the scheduler storage. |
Scheduler |
Fires when a resource’s property is about to be changed. |
Scheduler |
Occurs when a scheduler’s resource in a collection is changed. |
Scheduler |
Allows the deletion of a resource to be cancelled. |
Scheduler |
Occurs after a scheduler’s resource |
You can download the event viewer to track when data storage events raise.