Remarks

The ScheduleListDataSource class provides the ability to specify an item source from which data objects which represent appointments can be obtained.

In cases where the name or data type of the data object property does not match the name or data type of the corresponding appointment property, a mapping can be used to resolve the name and/or type.

In cases where the name or data type of the data object property does not match the name or data type of the corresponding appointment property, a mapping can be used to resolve the name and/or type.

For example, assume there exists a data object property named 'StartDate', which is the property from which the appointment's Start property value is obtained.

To create a mapping between these two properties, a new AppointmentPropertyMapping object is created with a Property value of Start, and a DataObjectPropertyName of 'StartDate', i.e., the actual name of the data object property.

This AppointmentPropertyMapping object is then added to the ScheduleListDataSource's AppointmentPropertyMappings collection; this signifies to the data source that the value the Appointment's Start property is to be obtained/assigned from/to a property named 'StartDate' on the data object.

A property mapping can also be used to perform bi-directional conversions between an appointment property and the corresponding data object property using the ConvertCallback AND ConvertBackCallback properties. These properties accept a delegate which is invoked whenever data is transferred between the appointment and it's underlying data object, providing the ability to change the value.