Represents a base class for data binding providers that facilitate two-way data binding between scheduler items and external data sources, providing mapping capabilities and change tracking.
Definition
Namespace:Telerik.WinControls.UI.Scheduler
Assembly:Telerik.WinControls.Scheduler.dll
Type Parameters:
T
The type of scheduler item that implements IDataBoundItem.
Syntax:
public abstract class BindingProviderBase<T> : BindingSource, IComponent, IDisposable, IBindingListView, IBindingList, IList, ICollection, IEnumerable, ITypedList, ICancelAddNew, ISupportInitializeNotification, ISupportInitialize, ICurrencyManagerProvider, ISchedulerProvider<T> where T : IDataBoundItemInheritance: objectMarshalByRefObjectComponentBindingSourceBindingProviderBase<T>
Derived Classes:
Implements:
Inherited Members
Constructors
Initializes a new instance of the BindingProviderBase<T> class with the specified data source owner.
protected BindingProviderBase(SchedulerBindingDataSource owner)The SchedulerBindingDataSource that owns this binding provider.
Fields
schedulerItems
List<T>
protected List<T> schedulerItemsProperties
Gets or sets the mapping information that defines how properties of scheduler items correspond to properties in the data source, enabling bidirectional data binding.
public virtual IMappingInfo Mapping { get; set; }Implements:
Gets or sets a value indicating whether changes to the underlying data source should be tracked and synchronized with scheduler items.
public bool TrackDataSourceChanges { get; set; }Methods
When overridden in a derived class, creates a new instance of the specific scheduler item type.
protected abstract T CreateInstance()T
A new instance of type T.
Deletes a scheduler item from the data source and removes it from the scheduler items collection.
public virtual void Delete(T itemToDelete)The scheduler item to delete from the data source.
Implements:
Performs the core deletion logic for removing a scheduler item from the data source.
protected virtual void DeleteCore(T itemToDelete)The scheduler item to delete.
Finds a property descriptor in the data source properties collection that matches the specified mapping.
protected PropertyDescriptor FindDataSourceProperty(SchedulerMapping mapping)The scheduler mapping that defines the data source property to find.
Returns:The PropertyDescriptor for the data source property, or null if not found.
Retrieves scheduler items from the data source, optionally applying a filter function.
public IEnumerable<T> GetItems(Predicate<T> filterFunction)An optional filter function to apply when retrieving items. If null, all items are returned.
Returns:IEnumerable<T>
An enumerable collection of scheduler items of type T.
Implements:
Gets the name of a data source property, allowing for custom property name transformations. Override this method to implement custom property naming strategies.
protected virtual string GetSourcePropertyName(PropertyDescriptor property)The property descriptor for which to get the name.
Returns:The name to use for the property in data binding operations.
Inserts a new scheduler item into the data source and synchronizes the change with the underlying data store.
public virtual void Insert(T itemToInsert)The scheduler item to insert into the data source.
Implements:
Performs the core insertion logic for adding a scheduler item to the data source.
protected virtual void InsertCore(T itemToInsert)The scheduler item to insert.
Called before the process of extracting scheduler items from the data source begins. Override this method to perform initialization or preparation tasks.
protected virtual void OnCreateSchedulerItemsBegin(PropertyDescriptorCollection properties)The collection of properties available on the data source items.
Called after the process of extracting scheduler items from the data source completes. Override this method to perform cleanup or finalization tasks.
protected virtual void OnCreateSchedulerItemsEnd()Raises the DataMemberChanged event and updates the data properties cache.
Raises the DataSourceChanged event and updates the data properties cache.
Raises the ItemsChanged event to notify subscribers of changes to the scheduler items collection.
protected virtual void OnItemsChanged(ListChangedEventArgs<T> args)The ListChangedEventArgs<T> instance containing the event data.
Raises the ListChanged event and handles synchronization between the data source and scheduler items.
protected override void OnListChanged(ListChangedEventArgs e)A ListChangedEventArgs that contains the event data.
Overrides:
Called to process a value from the data source when the corresponding scheduler item property cannot be found or when custom processing is required. Override this method to handle complex mappings.
protected virtual void ProcessDataSourceValue(T schedulerItem, SchedulerMapping mapping, object value)The scheduler item being populated.
mappingSchedulerMappingThe mapping configuration for the current property.
valueobjectThe value from the data source that needs processing.
Called to process a scheduler item value when updating the data source and custom processing is required. Override this method to handle complex mappings during data source updates.
protected virtual void ProcessSchedulerItem(T schedulerItem, object dataSourceItem, SchedulerMapping mapping, PropertyDescriptor dataItemProperty)The scheduler item containing the source value.
dataSourceItemobjectThe data source item being updated.
mappingSchedulerMappingThe mapping configuration for the current property.
dataItemPropertyPropertyDescriptorThe property descriptor for the data source property being updated.
Populates a scheduler item with data from the corresponding data source item using the configured property mappings.
protected virtual void ReadSchedulerItem(T schedulerItem, object item)The scheduler item to populate with data.
itemobjectThe data source item containing the source data.
Determines whether a specific mapping should be applied during data binding operations. Override this method to implement conditional mapping logic.
protected virtual bool ShouldApplyMapping(SchedulerMapping mapping)The scheduler mapping to evaluate.
Returns:true if the mapping should be applied; otherwise, false.
Determines whether a specific data source item should be processed and converted to a scheduler item. Override this method to implement custom filtering logic during data source enumeration.
Updates an existing scheduler item in the data source with new property values.
public virtual void Update(T itemToUpdate, string propertyName)The scheduler item to update in the data source.
propertyNamestringThe name of the specific property that changed, or null/empty to update all properties.
Implements:
Updates any child or related items after a modification operation. Override this method to provide custom child item synchronization logic.
protected virtual void UpdateChildItems()Performs the core update logic for modifying a scheduler item in the data source.
protected virtual void UpdateCore(T itemToUpdate, string propertyName)The scheduler item to update.
propertyNamestringThe name of the specific property that changed, or null/empty to update all properties.
Updates the properties of a data source item with values from the corresponding scheduler item.
protected void UpdateDataItem(T itemToUpdate, object dataItem, string propertyName)The scheduler item containing the source values.
dataItemobjectThe data source item to update.
propertyNamestringThe name of the specific property to update, or null/empty to update all properties.
Updates all mapped properties of a data source item with values from the corresponding scheduler item.
protected virtual void UpdateDataItemProperties(object item, T schedulerItem)The data source item to update.
schedulerItemTThe scheduler item containing the source values.
Updates a specific property of a data source item with the corresponding value from a scheduler item using the provided mapping.
protected virtual bool UpdateDataItemProperty(object item, T schedulerItem, SchedulerMapping mapping)The data source item to update.
schedulerItemTThe scheduler item containing the source value.
mappingSchedulerMappingThe mapping configuration that defines the property relationship.
Returns:true if the property was successfully updated; otherwise, false.
Updates the cached collection of data source property descriptors based on the current data list.
protected void UpdateDataPropertiesCache()Updates the cached collection of scheduler item property descriptors based on the current scheduler item type.
protected void UpdateSchedulerPropertiesCache()Events
Occurs when the scheduler items collection changes due to data source modifications.
public event EventHandler<ListChangedEventArgs<T>> ItemsChangedImplements: