Provides a base implementation of IDataSource that data source implementations can further extend.

Inheritance

object

Classes that extend this class.

Derived Classes
Implements
  • IComponent
  • IHandleEvent
  • IHandleAfterRender
  • JsonSerializable

constructor

public IgbBaseDataSource()

Returns IgbBaseDataSource

Inherited from: BaseRendererElement

[Inject]
protected IIgniteUIBlazor IgBlazor { get; set; }

Inherited from: BaseRendererElement

public bool IsComponentRooted { get; }

Inherited from: BaseRendererElement

protected virtual string ParentTypeName { get; }

Inherited from: BaseRendererElement

protected virtual bool UseDirectRender { get; }

Inherited from: BaseRendererElement

[Parameter]
public RenderFragment ChildContent { get; set; }

Inherited from: BaseRendererElement

protected virtual bool SupportsVisualChildren { get; }

Inherited from: BaseRendererElement

[Parameter]
public string Name { get; set; }

Inherited from: BaseRendererElement

public object Parent { get; }

Inherited from: BaseRendererElement

protected virtual string MethodTarget { get; }

Inherited from: BaseRendererElement

protected object CurrParent { get; }

Gets the current actual full count of the items in the data source.

[Parameter]
public int ActualCount { get; set; }

Gets or sets whether the auto refresh mechanism of the data source is currently defered. The data source will not react to most setting changes while this is set to true an will instead defer processing. Setting this value to false will queue a new refresh.

[Parameter]
public bool DeferAutoRefresh { get; set; }

Gets or sets which index consumers of the data source desire to be the current first visible index. A grid, for example, would indicate the current visible top row, and update this as that changes.

[Parameter]
public int FirstVisibleIndexRequested { get; set; }

Gets or sets whether the data source should include summary rows inside the group when summaries are present.

[Parameter]
public virtual bool IncludeSummaryRowsInSection { get; set; }

Gets or sets whether batch edits are enabled.

[Parameter]
public virtual bool IsBatchingEnabled { get; set; }

Gets or sets whether the data source is read-only or not.

[Parameter]
public bool IsReadOnly { get; set; }

Gets or sets if sections are collapsable.

[Parameter]
public virtual bool IsSectionCollapsable { get; set; }

Gets or sets whether content besides the section headers are displayed.

[Parameter]
public virtual bool IsSectionContentVisible { get; set; }

Gets or sets whether sections default to expanded or collapsed when they are created.

[Parameter]
public virtual bool IsSectionExpandedDefault { get; set; }

Gets or sets whether the section headers are treated as normal rows.

[Parameter]
public virtual bool IsSectionHeaderNormalRow { get; set; }

Gets or sets whether the summary rows within a section are placed at the bottom of the section, otherwise they will be placed at the top.

[Parameter]
public virtual bool IsSectionSummaryRowsAtBottom { get; set; }

Gets or sets which index consumers of the data source desire to be the current last visible index. A grid, for example, would indicate the current visible top row, and update this as that changes.

[Parameter]
public int LastVisibleIndexRequested { get; set; }

Gets or sets a list of property references that indicate the user provided primary key of the items in the data source. Consumers of the data source will often need to uniquely identify items in the data source. For this purpose a primary key should be specified.

[Parameter]
public string[] PrimaryKey { get; set; }

Gets or sets a list of property references for the properties desired by the consumer of the data source. If known, the data source may take steps to request only those properties, or to ensure that those properties are included, rather than the default behavior for this type of data source.

[Parameter]
public string[] PropertiesRequested { get; set; }

Gets or sets what properties should be included when resolving the datasource schema. If null, all properties are included.

[Parameter]
public string[] SchemaIncludedProperties { get; set; }

Gets or sets how section headers are displayed.

[Parameter]
public virtual DataSourceSectionHeaderDisplayMode SectionHeaderDisplayMode { get; set; }
[Parameter]
public bool ShouldEmitSectionFooters { get; set; }
[Parameter]
public bool ShouldEmitSectionHeaders { get; set; }
[Parameter]
public bool ShouldEmitShiftedRows { get; set; }
[Parameter]
public bool ShouldEmitSummaryRows { get; set; }
public override string Type { get; }

Inherited from: BaseRendererElement

protected string _name

Inherited from: BaseRendererElement

protected Dictionary<Type, Dictionary<string, FieldInfo>> eventCallbacksCache

Inherited from: BaseRendererElement

protected string _cachedSerializedContent

Inherited from: BaseRendererElement

protected virtual void EnsureModulesLoaded()

Returns any

Inherited from: BaseRendererElement

protected override void BuildRenderTree(RenderTreeBuilder builder)

Parameters

  • builder: RenderTreeBuilder

Returns any

OnElementNameChanged(BaseRendererElement, string, string)

Section titled "OnElementNameChanged(BaseRendererElement, string, string)"

Inherited from: BaseRendererElement

protected void OnElementNameChanged(BaseRendererElement element, string oldName, string newName)

Parameters

  • element: BaseRendererElement
  • oldName: string
  • newName: string

Returns any

InvokeMethod(string, object[], string[], ElementReference[])

Section titled "InvokeMethod(string, object[], string[], ElementReference[])"

Inherited from: BaseRendererElement

protected Task<object> InvokeMethod(string methodName, object[] arguments, string[] types, ElementReference[] nativeElements = null)

Parameters

  • methodName: string
  • arguments: object[]
  • types: string[]
  • nativeElements: ElementReference[]

Returns any

InvokeMethodSync(string, object[], string[], ElementReference[])

Section titled "InvokeMethodSync(string, object[], string[], ElementReference[])"

Inherited from: BaseRendererElement

protected object InvokeMethodSync(string methodName, object[] arguments, string[] types, ElementReference[] nativeElements = null)

Parameters

  • methodName: string
  • arguments: object[]
  • types: string[]
  • nativeElements: ElementReference[]

Returns any

InvokeMethodHelper(string, string, object[], string[], ElementReference[])

Section titled "InvokeMethodHelper(string, string, object[], string[], ElementReference[])"

Inherited from: BaseRendererElement

protected Task<object> InvokeMethodHelper(string target, string methodName, object[] arguments, string[] types, ElementReference[] nativeElements)

Parameters

  • target: string
  • methodName: string
  • arguments: object[]
  • types: string[]
  • nativeElements: ElementReference[]

Returns any

InvokeMethodHelperSync(string, string, object[], string[], ElementReference[])

Section titled "InvokeMethodHelperSync(string, string, object[], string[], ElementReference[])"

Inherited from: BaseRendererElement

protected object InvokeMethodHelperSync(string target, string methodName, object[] arguments, string[] types, ElementReference[] nativeElements)

Parameters

  • target: string
  • methodName: string
  • arguments: object[]
  • types: string[]
  • nativeElements: ElementReference[]

Returns any

Inherited from: BaseRendererElement

protected bool IsPropDirty(string propertyName)

Parameters

  • propertyName: string

Returns any

Serialize(SerializationContext, string)

Section titled "Serialize(SerializationContext, string)"

Inherited from: BaseRendererElement

public void Serialize(SerializationContext context, string propertyName = null)

Parameters

  • context: SerializationContext
  • propertyName: string

Returns any

Inherited from: BaseRendererElement

public string Serialize()

Returns any

Inherited from: BaseRendererElement

protected void EnsureValid()

Returns any

FromEventJson(BaseRendererControl, Dictionary<string, object>)

Section titled "FromEventJson(BaseRendererControl, Dictionary<string, object>)"

Inherited from: BaseRendererElement

protected virtual void FromEventJson(BaseRendererControl control, Dictionary<string, object> args)

Parameters

  • control: BaseRendererControl
  • args: Dictionary

Returns any

ToEventJson(BaseRendererControl, Dictionary<string, object>)

Section titled "ToEventJson(BaseRendererControl, Dictionary<string, object>)"

Inherited from: BaseRendererElement

protected virtual void ToEventJson(BaseRendererControl control, Dictionary<string, object> args)

Parameters

  • control: BaseRendererControl
  • args: Dictionary

Returns any

SetResourceStringAsync(string, string, string)

Section titled "SetResourceStringAsync(string, string, string)"

Inherited from: BaseRendererElement

protected Task<object> SetResourceStringAsync(string grouping, string id, string value)

Parameters

  • grouping: string
  • id: string
  • value: string

Returns any

SetResourceStringAsync(string, string)

Section titled "SetResourceStringAsync(string, string)"

Inherited from: BaseRendererElement

protected Task<object> SetResourceStringAsync(string grouping, string json)

Parameters

  • grouping: string
  • json: string

Returns any

public void AcceptPendingCommit(int commitID)

Parameters

  • commitID: int

Returns any

Accepts a commit with the provided ID.

public Task AcceptPendingCommitAsync(int commitID)

Parameters

  • commitID: int

Returns any

public void AcceptPendingTransaction(int transactionID)

Parameters

  • transactionID: int

Returns any

Save a specific pending transaction.

public Task AcceptPendingTransactionAsync(int transactionID)

Parameters

  • transactionID: int

Returns any

public void AddItem(object item)

Parameters

  • item: object

Returns any

public Task AddItemAsync(object item)

Parameters

  • item: object

Returns any

public void CancelEdits()

Returns any

Cancels any batched edits that may exist.

public Task CancelEditsAsync()

Returns any

public virtual void ClearPinnedRows()

Returns any

public virtual Task ClearPinnedRowsAsync()

Returns any

public virtual DataSource Clone()

Returns any

Clones this data source instance, copying the summary, grouping, filter and sorting settings into the new instance.

public virtual Task<DataSource> CloneAsync()

Returns any

public virtual void CloneProperties(DataSource dataSource)

Parameters

  • dataSource: DataSource

Returns any

Clones the properties over to the provided datasource.

public virtual Task ClonePropertiesAsync(DataSource dataSource)

Parameters

  • dataSource: DataSource

Returns any

public int CommitEdits(bool isPending)

Parameters

  • isPending: bool

Returns any

Commit the current edits to the datasource.

public Task<int> CommitEditsAsync(bool isPending)

Parameters

  • isPending: bool

Returns any

public override object FindByName(string name)

Parameters

  • name: string

Returns any

public void FlushAutoRefresh()

Returns any

Called to make sure a queued refresh of the data source has been applied before continuing. Should only be needed if you are trying to synchronously examine the results of changing settings on the data source. Note, for a virtual data source, the data source itself may be waiting for other synchronous requests to actualize data. This call will not wait for those, but will only make sure the appropriate requests are in flight from the settings changes

public Task FlushAutoRefreshAsync()

Returns any

public IgbDataSourceAggregatedResult[] GetAggregatedChanges(int commitID)

Parameters

  • commitID: int

Returns any

Returns a set of changes that have been made to the data however have not been committed yet.

public Task<IgbDataSourceAggregatedResult[]> GetAggregatedChangesAsync(int commitID)

Parameters

  • commitID: int

Returns any

public virtual bool GetIsRowExpandedAtIndex(int rowIndex)

Parameters

  • rowIndex: int

Returns any

Gets the expansion state for a row.

public virtual Task<bool> GetIsRowExpandedAtIndexAsync(int rowIndex)

Parameters

  • rowIndex: int

Returns any

public virtual object GetItemAtIndex(int index)

Parameters

  • index: int

Returns any

Returns the item at the specific index in the data source. This index is based on the data source's current view of the data, not the actual underlying indexes of the original source.

public virtual Task<object> GetItemAtIndexAsync(int index)

Parameters

  • index: int

Returns any

public virtual object GetItemFromKey(object[] key)

Parameters

  • key: object[]

Returns any

public virtual Task<object> GetItemFromKeyAsync(object[] key)

Parameters

  • key: object[]

Returns any

public virtual object GetItemProperty(object item, string propertyName)

Parameters

  • item: object
  • propertyName: string

Returns any

GetItemPropertyAsync(object, string)

Section titled "GetItemPropertyAsync(object, string)"
public virtual Task<object> GetItemPropertyAsync(object item, string propertyName)

Parameters

  • item: object
  • propertyName: string

Returns any

GetItemPropertyAtIndex(int, string)

Section titled "GetItemPropertyAtIndex(int, string)"
public virtual object GetItemPropertyAtIndex(int index, string valueName)

Parameters

  • index: int
  • valueName: string

Returns any

GetItemPropertyAtIndexAsync(int, string)

Section titled "GetItemPropertyAtIndexAsync(int, string)"
public virtual Task<object> GetItemPropertyAtIndexAsync(int index, string valueName)

Parameters

  • index: int
  • valueName: string

Returns any

GetMainValuePath(DataSourceRowType)

Section titled "GetMainValuePath(DataSourceRowType)"
public virtual string GetMainValuePath(DataSourceRowType rowType)

Parameters

  • rowType: DataSourceRowType

Returns any

GetMainValuePathAsync(DataSourceRowType)

Section titled "GetMainValuePathAsync(DataSourceRowType)"
public virtual Task<string> GetMainValuePathAsync(DataSourceRowType rowType)

Parameters

  • rowType: DataSourceRowType

Returns any

public virtual IgbDataGridSummaryResult[] GetRootSummaryResults()

Returns any

Gets the summary results for the root level.

public virtual Task<IgbDataGridSummaryResult[]> GetRootSummaryResultsAsync()

Returns any

public virtual int GetRootSummaryRowCount()

Returns any

Gets the number of summary rows at the root level.

public virtual Task<int> GetRootSummaryRowCountAsync()

Returns any

public virtual int GetRowCount()

Returns any

Gets the current actual full count of the items in the data source.

public virtual Task<int> GetRowCountAsync()

Returns any

public virtual int GetRowLevel(int rowIndex)

Parameters

  • rowIndex: int

Returns any

Gets the hierarchy level of the row.

public virtual Task<int> GetRowLevelAsync(int rowIndex)

Parameters

  • rowIndex: int

Returns any

public virtual DataSourceRowType GetRowType(int rowIndex)

Parameters

  • rowIndex: int

Returns any

public virtual Task<DataSourceRowType> GetRowTypeAsync(int rowIndex)

Parameters

  • rowIndex: int

Returns any

public virtual IgbDataGridSummaryResult[][] GetSectionSummaryResults(int sectionIndex)

Parameters

  • sectionIndex: int

Returns any

Gets the summary results for a specific section.

public virtual Task<IgbDataGridSummaryResult[][]> GetSectionSummaryResultsAsync(int sectionIndex)

Parameters

  • sectionIndex: int

Returns any

public virtual int GetStickyRowPriority(int row)

Parameters

  • row: int

Returns any

public virtual Task<int> GetStickyRowPriorityAsync(int row)

Parameters

  • row: int

Returns any

public string GetTransactionErrorByID(int transactionID)

Parameters

  • transactionID: int

Returns any

Returns an error, if any, associated with a specific transaction.

public Task<string> GetTransactionErrorByIDAsync(int transactionID)

Parameters

  • transactionID: int

Returns any

GetTransactionErrorByKey(object[], string)

Section titled "GetTransactionErrorByKey(object[], string)"
public string GetTransactionErrorByKey(object[] key, string propertyPath)

Parameters

  • key: object[]
  • propertyPath: string

Returns any

GetTransactionErrorByKeyAsync(object[], string)

Section titled "GetTransactionErrorByKeyAsync(object[], string)"
public Task<string> GetTransactionErrorByKeyAsync(object[] key, string propertyPath)

Parameters

  • key: object[]
  • propertyPath: string

Returns any

public int GetTransactionID(object[] key, string propertyPath)

Parameters

  • key: object[]
  • propertyPath: string

Returns any

GetTransactionIDAsync(object[], string)

Section titled "GetTransactionIDAsync(object[], string)"
public Task<int> GetTransactionIDAsync(object[] key, string propertyPath)

Parameters

  • key: object[]
  • propertyPath: string

Returns any

public bool HasAdd(object item)

Parameters

  • item: object

Returns any

Returns whether the item is an uncommitted add.

public Task<bool> HasAddAsync(object item)

Parameters

  • item: object

Returns any

public bool HasDelete(object[] key)

Parameters

  • key: object[]

Returns any

public Task<bool> HasDeleteAsync(object[] key)

Parameters

  • key: object[]

Returns any

public bool HasEdit(object[] key, string propertyPath)

Parameters

  • key: object[]
  • propertyPath: string

Returns any

public Task<bool> HasEditAsync(object[] key, string propertyPath)

Parameters

  • key: object[]
  • propertyPath: string

Returns any

public virtual int IndexOfItem(object item)

Parameters

  • item: object

Returns any

Called to return the index for an item contained in the data source, or -1, if the item can't be found, or this action isn't currently supported.

public virtual Task<int> IndexOfItemAsync(object item)

Parameters

  • item: object

Returns any

public virtual int IndexOfKey(object[] key)

Parameters

  • key: object[]

Returns any

public virtual Task<int> IndexOfKeyAsync(object[] key)

Parameters

  • key: object[]

Returns any

public virtual bool IsExclusivelySticky(int row)

Parameters

  • row: int

Returns any

public virtual Task<bool> IsExclusivelyStickyAsync(int row)

Parameters

  • row: int

Returns any

public bool IsPendingCommit(int commitID)

Parameters

  • commitID: int

Returns any

Returns whether a commit is pending or not.

public Task<bool> IsPendingCommitAsync(int commitID)

Parameters

  • commitID: int

Returns any

public bool IsPendingTransaction(int transactionID)

Parameters

  • transactionID: int

Returns any

Returns whether a transaction pending or not.

public Task<bool> IsPendingTransactionAsync(int transactionID)

Parameters

  • transactionID: int

Returns any

public virtual bool IsPlaceholderItem(int index)

Parameters

  • index: int

Returns any

Returns true if the item at the requested index is a placeholder item and has not been actualized.

public virtual Task<bool> IsPlaceholderItemAsync(int index)

Parameters

  • index: int

Returns any

public virtual bool IsRowPinned(int row)

Parameters

  • row: int

Returns any

public virtual Task<bool> IsRowPinnedAsync(int row)

Parameters

  • row: int

Returns any

public virtual bool IsRowSpanning(DataSourceRowType rowType)

Parameters

  • rowType: DataSourceRowType

Returns any

IsRowSpanningAsync(DataSourceRowType)

Section titled "IsRowSpanningAsync(DataSourceRowType)"
public virtual Task<bool> IsRowSpanningAsync(DataSourceRowType rowType)

Parameters

  • rowType: DataSourceRowType

Returns any

public void NotifyClearItems()

Returns any

Manually notifies the data source that the data it has bound to has been cleared and needs to be re-examined. This should not be necessary to call if the data that the data source is bound to is already observable.

public Task NotifyClearItemsAsync()

Returns any

public void NotifyInsertItem(int index, object newItem)

Parameters

  • index: int
  • newItem: object

Returns any

public Task NotifyInsertItemAsync(int index, object newItem)

Parameters

  • index: int
  • newItem: object

Returns any

public void NotifyRemoveItem(int index, object oldItem)

Parameters

  • index: int
  • oldItem: object

Returns any

public Task NotifyRemoveItemAsync(int index, object oldItem)

Parameters

  • index: int
  • oldItem: object

Returns any

public void NotifySetItem(int index, object oldItem, object newItem)

Parameters

  • index: int
  • oldItem: object
  • newItem: object

Returns any

NotifySetItemAsync(int, object, object)

Section titled "NotifySetItemAsync(int, object, object)"
public Task NotifySetItemAsync(int index, object oldItem, object newItem)

Parameters

  • index: int
  • oldItem: object
  • newItem: object

Returns any

public virtual void PinRow(object[] key)

Parameters

  • key: object[]

Returns any

public virtual Task PinRowAsync(object[] key)

Parameters

  • key: object[]

Returns any

public void QueueAutoRefresh()

Returns any

Called to manually queue a refresh of the data source.

public Task QueueAutoRefreshAsync()

Returns any

public void Redo()

Returns any

Redo the last undo.

public Task RedoAsync()

Returns any

public void Refresh()

Returns any

Called to synchronously refresh the data source.

public Task RefreshAsync()

Returns any

public void RejectPendingCommit(int commitID)

Parameters

  • commitID: int

Returns any

Cancel a commit with the provided ID.

public Task RejectPendingCommitAsync(int commitID)

Parameters

  • commitID: int

Returns any

public void RejectPendingTransaction(int transactionID)

Parameters

  • transactionID: int

Returns any

Rejects a pending transaction.

public Task RejectPendingTransactionAsync(int transactionID)

Parameters

  • transactionID: int

Returns any

public void RemoveItem(object item)

Parameters

  • item: object

Returns any

Removes an item from the datasource.

public Task RemoveItemAsync(object item)

Parameters

  • item: object

Returns any

public virtual void RemoveItemByKey(object[] key)

Parameters

  • key: object[]

Returns any

public virtual Task RemoveItemByKeyAsync(object[] key)

Parameters

  • key: object[]

Returns any

public virtual DataSourceSchemaPropertyType ResolveSchemaPropertyType(string propertyPath)

Parameters

  • propertyPath: string

Returns any

ResolveSchemaPropertyTypeAsync(string)

Section titled "ResolveSchemaPropertyTypeAsync(string)"

Resolve a property or property path to its value type.

public virtual Task<DataSourceSchemaPropertyType> ResolveSchemaPropertyTypeAsync(string propertyPath)

Parameters

  • propertyPath: string

Returns any

SetCustomizedStringAsync(string, string)

Section titled "SetCustomizedStringAsync(string, string)"

Provide a new set of localized strings to use for a given languange.

public Task<object> SetCustomizedStringAsync(string language, string json)

Parameters

  • language: string
  • json: string

Returns any

SetCustomizedStringAsync(string, string, string)

Section titled "SetCustomizedStringAsync(string, string, string)"

Provide a new set of localized strings to use for a given languange.

public Task<object> SetCustomizedStringAsync(string language, string id, string value)

Parameters

  • language: string
  • id: string
  • value: string

Returns any

public virtual void SetIsRowExpandedAtIndex(int rowIndex, bool isExpanded)

Parameters

  • rowIndex: int
  • isExpanded: bool

Returns any

SetIsRowExpandedAtIndexAsync(int, bool)

Section titled "SetIsRowExpandedAtIndexAsync(int, bool)"
public virtual Task SetIsRowExpandedAtIndexAsync(int rowIndex, bool isExpanded)

Parameters

  • rowIndex: int
  • isExpanded: bool

Returns any

public void SetTransactionError(int transactionID, string message)

Parameters

  • transactionID: int
  • message: string

Returns any

SetTransactionErrorAsync(int, string)

Section titled "SetTransactionErrorAsync(int, string)"
public Task SetTransactionErrorAsync(int transactionID, string message)

Parameters

  • transactionID: int
  • message: string

Returns any

public void Undo()

Returns any

Undo the last edit.

public Task UndoAsync()

Returns any

public virtual void UnpinRow(object[] key)

Parameters

  • key: object[]

Returns any

public virtual Task UnpinRowAsync(object[] key)

Parameters

  • key: object[]

Returns any

UpdatePropertyAtKey(object[], string, object, bool)

Section titled "UpdatePropertyAtKey(object[], string, object, bool)"
public virtual int UpdatePropertyAtKey(object[] key, string propertyPath, object value, bool isPending = false)

Parameters

  • key: object[]
  • propertyPath: string
  • value: object
  • isPending: bool

Returns any

UpdatePropertyAtKeyAsync(object[], string, object, bool)

Section titled "UpdatePropertyAtKeyAsync(object[], string, object, bool)"
public virtual Task<int> UpdatePropertyAtKeyAsync(object[] key, string propertyPath, object value, bool isPending = false)

Parameters

  • key: object[]
  • propertyPath: string
  • value: object
  • isPending: bool

Returns any

[Parameter]
public EventCallback<IgbDataSourcePropertiesRequestedChangedEventArgs> PropertiesRequestedChanged { get; set; }
[Parameter]
public EventCallback<IgbDataSourceRootSummariesChangedEventArgs> RootSummariesChanged { get; set; }
[Parameter]
public EventCallback<IgbDataSourceRowExpansionChangedEventArgs> RowExpansionChanged { get; set; }
[Parameter]
public EventCallback<IgbDataSourceSchemaChangedEventArgs> SchemaChanged { get; set; }
[Parameter]
public string PropertiesRequestedChangedScript { get; set; }
[Parameter]
public string RootSummariesChangedScript { get; set; }
[Parameter]
public string RowExpansionChangedScript { get; set; }
[Parameter]
public string SchemaChangedScript { get; set; }