New to Telerik UI for WinFormsStart a free 30-day trial

Base implementation of IDataProvider.

Definition

Namespace:Telerik.Pivot.Core

Assembly:Telerik.WinControls.PivotGrid.dll

Syntax:

C#
public abstract class DataProviderBase : IDataProvider, INotifyPropertyChanged, ISupportInitialize

Inheritance: objectDataProviderBase

Derived Classes: LocalDataSourceProviderOlapDataProviderQueryableDataProvider

Implements: IDataProviderINotifyPropertyChangedISupportInitialize

Properties

C#
public int AggregatesLevel { get; set; }
C#
public PivotAxis AggregatesPosition { get; set; }

Gets or sets a value that indicates if changes to this IDataProvider will trigger automatic Refresh().

C#
public bool DeferUpdates { get; set; }

Implements: IDataProvider.DeferUpdates

C#
public IFieldDescriptionProvider FieldDescriptionsProvider { get; set; }

Gets the IFieldInfoData instance that provided information for all available properties of the data source.

C#
public IFieldInfoData FieldInfos { get; protected set; }
Property Value:

The field information.

Implements: IDataProvider.FieldInfos

Gets a value that indicates if there are pending changes since the last Refresh(). The value will be true after a change is applied. The value will be false after an automatic or user triggered Refresh(). The value will be false during any work or download process so even if false Results may not be ready yet. In that case you may check Status for additional information.

C#
public bool HasPendingChanges { get; }

Implements: IDataProvider.HasPendingChanges

Results

IPivotResults

C#
protected abstract IPivotResults Results { get; }
C#
protected IPivotSettings Settings { get; }

Gets the state object that is provided to GetDescriptionsDataAsync(object) method.

C#
public abstract object State { get; }
Property Value:

The object that will be passed to GetDescriptionsDataAsync(object) method.

Implements: IDataProvider.State

C#
public DataProviderStatus Status { get; }

Methods

C#
public void BeginInit()

Implements: ISupportInitialize.BeginInit()

Block the calling thread until all calculations performed by calling Refresh() method completes.

C#
public abstract void BlockUntilRefreshCompletes()

Implements: IDataProvider.BlockUntilRefreshCompletes()

Creates an instance of IFieldDescriptionProvider for this IDataProvider.

C#
protected abstract IFieldDescriptionProvider CreateFieldDescriptionsProvider()
Returns:

IFieldDescriptionProvider

Enters a defer cycle that you can use to merge changes to the provider and delay automatic refresh.

C#
public IDisposable DeferRefresh()
Returns:

IDisposable

An IDisposable object that you can use to dispose of the calling object.

Implements: IDataProvider.DeferRefresh()

C#
public void EndInit()

Implements: ISupportInitialize.EndInit()

Creates and returns an aggregate description suitable for the supplied field description.

C#
public IAggregateDescription GetAggregateDescriptionForFieldDescription(IPivotFieldInfo info)
Parameters:infoIPivotFieldInfo

A IPivotFieldInfo instance.

Returns:

IAggregateDescription

An IAggregateDescription instance.

Implements: IDataProvider.GetAggregateDescriptionForFieldDescription(IPivotFieldInfo)

Creates and returns an aggregate description suitable for the supplied field description.

C#
protected abstract IAggregateDescription GetAggregateDescriptionForFieldDescriptionCore(IPivotFieldInfo description)
Parameters:descriptionIPivotFieldInfo

A IPivotFieldInfo instance.

Returns:

IAggregateDescription

An IAggregateDescription instance.

Returns a filter description suitable for the supplied field description.

C#
public FilterDescription GetFilterDescriptionForFieldDescription(IPivotFieldInfo info)
Parameters:infoIPivotFieldInfo

A IPivotFieldInfo instance.

Returns:

FilterDescription

An FilterDescription instance.

Implements: IDataProvider.GetFilterDescriptionForFieldDescription(IPivotFieldInfo)

Returns a filter description suitable for the supplied field description.

C#
protected abstract FilterDescription GetFilterDescriptionForFieldDescriptionCore(IPivotFieldInfo description)
Parameters:descriptionIPivotFieldInfo

A IPivotFieldInfo instance.

Returns:

FilterDescription

An FilterDescription instance.

Creates and returns a group description suitable for the supplied field description.

C#
public IGroupDescription GetGroupDescriptionForFieldDescription(IPivotFieldInfo info)
Parameters:infoIPivotFieldInfo

A IPivotFieldInfo instance.

Returns:

IGroupDescription

An IGroupDescription instance.

Implements: IDataProvider.GetGroupDescriptionForFieldDescription(IPivotFieldInfo)

Creates and returns a group description suitable for the supplied field description.

C#
protected abstract IGroupDescription GetGroupDescriptionForFieldDescriptionCore(IPivotFieldInfo description)
Parameters:descriptionIPivotFieldInfo

A IPivotFieldInfo instance.

Returns:

IGroupDescription

An IGroupDescription instance.

Notify that changes were applied that would alter the pivot results. Queues an automatic Refresh().

C#
protected void Invalidate()

Called when FieldDescriptionsProvider is changed.

C#
protected virtual void OnFieldDescriptionsProviderChanged(IFieldDescriptionProvider oldProvider, IFieldDescriptionProvider newProvider)
Parameters:oldProviderIFieldDescriptionProvidernewProviderIFieldDescriptionProvider

Raises the event.

C#
protected virtual void OnPrepareDescriptionForField(PrepareDescriptionForFieldEventArgs args)
Parameters:argsPrepareDescriptionForFieldEventArgs

The PrepareDescriptionForFieldEventArgs instance containing the event data.

Raises PropertyChanged event.

C#
protected void OnPropertyChanged(string propertyName)
Parameters:propertyNamestring

Raises the event.

C#
protected virtual void OnStatusChanged(DataProviderStatusChangedEventArgs args)
Parameters:argsDataProviderStatusChangedEventArgs

The DataProviderStatusChangedEventArgs instance containing the event data.

C#
public void Refresh()

Recreates the Results.

C#
protected abstract void RefreshOverride()

Events

Occurs when description should be prepared for a specified field info.

C#
public event EventHandler<PrepareDescriptionForFieldEventArgs> PrepareDescriptionForField

Implements: IDataProvider.PrepareDescriptionForField

C#
public event PropertyChangedEventHandler PropertyChanged

Implements: INotifyPropertyChanged.PropertyChanged

C#
public event EventHandler<DataProviderStatusChangedEventArgs> StatusChanged