Provides binding functionality for scheduler events, handling data mapping between data source items and scheduler events.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.Scheduler.dll
Syntax:
public class SchedulerBindingDataSource.EventBindingProvider : BindingProviderBase<IEvent>, IComponent, IDisposable, IBindingListView, IBindingList, IList, ICollection, IEnumerable, ITypedList, ICancelAddNew, ISupportInitializeNotification, ISupportInitialize, ICurrencyManagerProvider, ISchedulerProvider<IEvent>Inheritance: objectMarshalByRefObjectComponentBindingSourceBindingProviderBase<IEvent>SchedulerBindingDataSource.EventBindingProvider...
Implements:
Inherited Members
Constructors
Initializes a new instance of the SchedulerBindingDataSource.EventBindingProvider class.
public EventBindingProvider(SchedulerBindingDataSource owner)The owner scheduler binding data source.
Properties
Gets or sets the factory used to create appointment objects. If not explicitly set, a default factory is used.
[Browsable(false)]
public IAppointmentFactory AppointmentFactory { get; set; }Gets or sets the factory used to create exception mappers that handle recurrence exceptions for recurring appointments.
[Browsable(false)]
public IExceptionMapperFactory ExceptionMapperFactory { get; set; }Gets or sets the callback used to determine if an event is a master event based on its master event ID.
public Predicate<object> IsMasterEventIdCallback { get; set; }Gets or sets the mapping information that defines how appointment properties are mapped to data source fields.
[Browsable(false)]
public override IMappingInfo Mapping { get; set; }Overrides:
Gets or sets the factory used to create resource mappers that handle the relationship between appointments and resources.
[Browsable(false)]
public IResourceMapperFactory ResourceMapperFactory { get; set; }Methods
Creates a new event instance using the configured appointment factory.
protected override IEvent CreateInstance()A new IEvent instance that can be used in the scheduler.
Overrides:
Deletes an event from the data source. For recurrence exceptions, removes the exception from the master event's exceptions list.
protected override void DeleteCore(IEvent itemToDelete)The event item to delete from the data source.
Overrides:
Inserts a new event item into the data source. If the item is a recurrence exception, it is added to the master event's exceptions list.
protected override void InsertCore(IEvent itemToInsert)The event item to insert into the data source.
Overrides:
Called at the beginning of creating scheduler items from the data source. Prepares the resource ID mapping and resets collection mappers.
protected override void OnCreateSchedulerItemsBegin(PropertyDescriptorCollection properties)The collection of properties from the data source.
Overrides:
Called when the data source is changed. Applies the recurrence ID converter based on the data source type.
protected override void OnDataSourceChanged(EventArgs e)Event arguments.
Overrides:
Processes special data source values that require custom handling, such as resources and exceptions. This is called when a value from the data source needs special processing beyond direct property mapping.
protected override void ProcessDataSourceValue(IEvent schedulerItem, SchedulerMapping mapping, object value)The scheduler event item being populated from the data source.
mappingSchedulerMappingThe mapping information for the property being processed.
valueobjectThe value from the data source to be processed.
Overrides:
Processes a scheduler item and applies special handling for resource mapping.
protected override void ProcessSchedulerItem(IEvent schedulerItem, object dataSourceItem, SchedulerMapping mapping, PropertyDescriptor dataItemProperty)The scheduler event item to process.
dataSourceItemobjectThe corresponding data source item.
mappingSchedulerMappingThe mapping definition to use.
dataItemPropertyPropertyDescriptorThe property descriptor for the data source property.
Overrides:
Resets the collection mappers for resources and exceptions.
public void ResetCollectionMappers()Determines whether a specific mapping should be applied when reading data from the data source. Prevents applying conflicting mappings for resources and master events.
protected override bool ShouldApplyMapping(SchedulerMapping mapping)The mapping to check.
Returns:True if the mapping should be applied; otherwise, false.
Overrides:
Determines whether a data item from the data source should be read as an event. Filters out items that are recurrence exceptions based on the MasterEventId property.
Returns a string that represents the current EventBindingProvider.
public override string ToString()A string that includes the type name and data source binding status.
Overrides:
Updates child items after the main data processing is complete. Processes the resource update queue to apply resource mappings.
protected override void UpdateChildItems()Overrides:
Updates an event in the data source. For recurrence exceptions, updates the exception directly without affecting the master event.