Interface
IDataProvider

Provides data access for pivot grouping.

Definition

Namespace:Telerik.Pivot.Core

Assembly:Telerik.Pivot.Core.dll

Syntax:

cs-api-definition
public interface IDataProvider : INotifyPropertyChanged, ISupportInitialize

Inherited Members INotifyPropertyChanged.PropertyChangedISupportInitialize.BeginInit()ISupportInitialize.EndInit()

Properties

AggregatesLevel

Gets or sets the position where groups for the aggregates should be placed.

Declaration

cs-api-definition
int AggregatesLevel { get; set; }

Property Value

int

AggregatesPosition

Gets or sets a value indicating where the aggregate groups should be positioned.

Declaration

cs-api-definition
PivotAxis AggregatesPosition { get; set; }

Property Value

PivotAxis

DeferUpdates

Gets or sets a property that indicates if changes to the grouping settings would trigger computations immediately when invalidated or on explicit Refresh().

Declaration

cs-api-definition
bool DeferUpdates { get; set; }

Property Value

bool

FieldInfos

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

Declaration

cs-api-definition
IFieldInfoData FieldInfos { get; }

Property Value

IFieldInfoData

The field information.

HasPendingChanges

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.

Declaration

cs-api-definition
bool HasPendingChanges { get; }

Property Value

bool

Results

Gets the results from the last grouping.

Declaration

cs-api-definition
IPivotResults Results { get; }

Property Value

IPivotResults

Settings

Gets or sets the IPivotSettings instance that is being used.

Declaration

cs-api-definition
IPivotSettings Settings { get; }

Property Value

IPivotSettings

State

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

Declaration

cs-api-definition
object State { get; }

Property Value

object

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

Status

Gets the status of this instance.

Declaration

cs-api-definition
DataProviderStatus Status { get; }

Property Value

DataProviderStatus

Methods

BlockUntilRefreshCompletes()

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

Declaration

cs-api-definition
void BlockUntilRefreshCompletes()

DeferRefresh()

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

Declaration

cs-api-definition
IDisposable DeferRefresh()

Returns

IDisposable

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

GetAggregateDescriptionForFieldDescription(IPivotFieldInfo)

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

Declaration

cs-api-definition
IAggregateDescription GetAggregateDescriptionForFieldDescription(IPivotFieldInfo info)

Parameters

info

IPivotFieldInfo

A IPivotFieldInfo instance.

Returns

IAggregateDescription

An IAggregateDescription instance.

GetAggregateFunctionsForAggregateDescription(IAggregateDescription)

Returns a list of suitable functions for the supplied aggregate description.

Declaration

cs-api-definition
[Obsolete("Not used. Obsoleted after 2013.Q2.SP1")]
IEnumerable<object> GetAggregateFunctionsForAggregateDescription(IAggregateDescription aggregateDescription)

Parameters

aggregateDescription

IAggregateDescription

The IAggregateDescription.

Returns

IEnumerable<object>

A list of possible aggregate functions.

GetFilterDescriptionForFieldDescription(IPivotFieldInfo)

Returns a filter description suitable for the supplied field description.

Declaration

cs-api-definition
FilterDescription GetFilterDescriptionForFieldDescription(IPivotFieldInfo info)

Parameters

info

IPivotFieldInfo

A IPivotFieldInfo instance.

Returns

FilterDescription

An FilterDescription instance.

GetGroupDescriptionForFieldDescription(IPivotFieldInfo)

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

Declaration

cs-api-definition
IGroupDescription GetGroupDescriptionForFieldDescription(IPivotFieldInfo info)

Parameters

info

IPivotFieldInfo

A IPivotFieldInfo instance.

Returns

IGroupDescription

An IGroupDescription instance.

Refresh()

Force recalculation operation.

Declaration

cs-api-definition
void Refresh()

SetAggregateFunctionToAggregateDescription(IAggregateDescription, object)

Set the aggregateFunction retrieved from GetAggregateFunctionsForAggregateDescription(IAggregateDescription) to the aggregateDescription.

Declaration

cs-api-definition
[Obsolete("Not used. Obsoleted after 2013.Q2.SP1")]
void SetAggregateFunctionToAggregateDescription(IAggregateDescription aggregateDescription, object aggregateFunction)

Parameters

aggregateDescription

IAggregateDescription

The IAggregateDescription.

aggregateFunction

object

The aggregate function.

Events

PrepareDescriptionForField

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

Declaration

cs-api-definition
event EventHandler<PrepareDescriptionForFieldEventArgs> PrepareDescriptionForField

Event Value

EventHandler<PrepareDescriptionForFieldEventArgs>

StatusChanged

Occurs when the current operation has completed.

Declaration

cs-api-definition
event EventHandler<DataProviderStatusChangedEventArgs> StatusChanged

Event Value

EventHandler<DataProviderStatusChangedEventArgs>