Show / Hide Table of Contents

Class IgbVirtualDataSource

A virtual data source which may not have synchronous access to all its data items, and resulting may synchronously return placeholders for items that have yet to be actualized.

Inheritance
System.Object
BaseRendererElement
IgbBaseDataSource
IgbVirtualDataSource
Implements
JsonSerializable
Inherited Members
IgbBaseDataSource.AddItemAsync(Object)
IgbBaseDataSource.AddItem(Object)
IgbBaseDataSource.SetCustomizedStringAsync(String, String)
IgbBaseDataSource.SetCustomizedStringAsync(String, String, String)
IgbBaseDataSource.RemoveItemAsync(Object)
IgbBaseDataSource.RemoveItem(Object)
IgbBaseDataSource.AcceptPendingTransactionAsync(Int32)
IgbBaseDataSource.AcceptPendingTransaction(Int32)
IgbBaseDataSource.RejectPendingTransactionAsync(Int32)
IgbBaseDataSource.RejectPendingTransaction(Int32)
IgbBaseDataSource.CommitEditsAsync(Boolean)
IgbBaseDataSource.CommitEdits(Boolean)
IgbBaseDataSource.CancelEditsAsync()
IgbBaseDataSource.CancelEdits()
IgbBaseDataSource.AcceptPendingCommitAsync(Int32)
IgbBaseDataSource.AcceptPendingCommit(Int32)
IgbBaseDataSource.RejectPendingCommitAsync(Int32)
IgbBaseDataSource.RejectPendingCommit(Int32)
IgbBaseDataSource.UndoAsync()
IgbBaseDataSource.Undo()
IgbBaseDataSource.RedoAsync()
IgbBaseDataSource.Redo()
IgbBaseDataSource.HasEditAsync(Object[], String)
IgbBaseDataSource.HasEdit(Object[], String)
IgbBaseDataSource.HasDeleteAsync(Object[])
IgbBaseDataSource.HasDelete(Object[])
IgbBaseDataSource.HasAddAsync(Object)
IgbBaseDataSource.HasAdd(Object)
IgbBaseDataSource.GetAggregatedChangesAsync(Int32)
IgbBaseDataSource.GetAggregatedChanges(Int32)
IgbBaseDataSource.IsPendingTransactionAsync(Int32)
IgbBaseDataSource.IsPendingTransaction(Int32)
IgbBaseDataSource.IsPendingCommitAsync(Int32)
IgbBaseDataSource.IsPendingCommit(Int32)
IgbBaseDataSource.SetTransactionErrorAsync(Int32, String)
IgbBaseDataSource.SetTransactionError(Int32, String)
IgbBaseDataSource.GetTransactionErrorByKeyAsync(Object[], String)
IgbBaseDataSource.GetTransactionErrorByKey(Object[], String)
IgbBaseDataSource.GetTransactionErrorByIDAsync(Int32)
IgbBaseDataSource.GetTransactionErrorByID(Int32)
IgbBaseDataSource.GetTransactionIDAsync(Object[], String)
IgbBaseDataSource.GetTransactionID(Object[], String)
IgbBaseDataSource.GetItemPropertyAsync(Object, String)
IgbBaseDataSource.GetItemProperty(Object, String)
IgbBaseDataSource.NotifySetItemAsync(Int32, Object, Object)
IgbBaseDataSource.NotifySetItem(Int32, Object, Object)
IgbBaseDataSource.NotifyClearItemsAsync()
IgbBaseDataSource.NotifyClearItems()
IgbBaseDataSource.NotifyInsertItemAsync(Int32, Object)
IgbBaseDataSource.NotifyInsertItem(Int32, Object)
IgbBaseDataSource.NotifyRemoveItemAsync(Int32, Object)
IgbBaseDataSource.NotifyRemoveItem(Int32, Object)
IgbBaseDataSource.QueueAutoRefreshAsync()
IgbBaseDataSource.QueueAutoRefresh()
IgbBaseDataSource.FlushAutoRefreshAsync()
IgbBaseDataSource.FlushAutoRefresh()
IgbBaseDataSource.RefreshAsync()
IgbBaseDataSource.Refresh()
IgbBaseDataSource.GetMainValuePathAsync(DataSourceRowType)
IgbBaseDataSource.GetMainValuePath(DataSourceRowType)
IgbBaseDataSource.IsRowSpanningAsync(DataSourceRowType)
IgbBaseDataSource.IsRowSpanning(DataSourceRowType)
IgbBaseDataSource.ClearPinnedRowsAsync()
IgbBaseDataSource.ClearPinnedRows()
IgbBaseDataSource.ResolveSchemaPropertyTypeAsync(String)
IgbBaseDataSource.ResolveSchemaPropertyType(String)
IgbBaseDataSource.GetRowCountAsync()
IgbBaseDataSource.GetRowCount()
IgbBaseDataSource.IsReadOnly
IgbBaseDataSource.ActualCount
IgbBaseDataSource.FirstVisibleIndexRequested
IgbBaseDataSource.LastVisibleIndexRequested
IgbBaseDataSource.DeferAutoRefresh
IgbBaseDataSource.PrimaryKey
IgbBaseDataSource.PropertiesRequested
IgbBaseDataSource.SchemaIncludedProperties
IgbBaseDataSource.SectionHeaderDisplayMode
IgbBaseDataSource.IncludeSummaryRowsInSection
IgbBaseDataSource.IsSectionSummaryRowsAtBottom
IgbBaseDataSource.IsSectionHeaderNormalRow
IgbBaseDataSource.IsSectionContentVisible
IgbBaseDataSource.ShouldEmitSectionHeaders
IgbBaseDataSource.ShouldEmitSectionFooters
IgbBaseDataSource.ShouldEmitShiftedRows
IgbBaseDataSource.ShouldEmitSummaryRows
IgbBaseDataSource.SchemaChangedScript
IgbBaseDataSource.SchemaChanged
IgbBaseDataSource.RowExpansionChangedScript
IgbBaseDataSource.RowExpansionChanged
IgbBaseDataSource.RootSummariesChangedScript
IgbBaseDataSource.RootSummariesChanged
IgbBaseDataSource.PropertiesRequestedChangedScript
IgbBaseDataSource.PropertiesRequestedChanged
BaseRendererElement._name
BaseRendererElement.eventCallbacksCache
BaseRendererElement._cachedSerializedContent
BaseRendererElement.EnsureModulesLoaded()
BaseRendererElement.BuildRenderTree(RenderTreeBuilder)
BaseRendererElement.OnElementNameChanged(BaseRendererElement, String, String)
BaseRendererElement.InvokeMethod(String, Object[], String[], ElementReference[])
BaseRendererElement.InvokeMethodSync(String, Object[], String[], ElementReference[])
BaseRendererElement.InvokeMethodHelper(String, String, Object[], String[], ElementReference[])
BaseRendererElement.InvokeMethodHelperSync(String, String, Object[], String[], ElementReference[])
BaseRendererElement.IsPropDirty(String)
BaseRendererElement.Serialize(SerializationContext, String)
BaseRendererElement.Serialize()
BaseRendererElement.EnsureValid()
BaseRendererElement.FromEventJson(BaseRendererControl, Dictionary<String, Object>)
BaseRendererElement.ToEventJson(BaseRendererControl, Dictionary<String, Object>)
BaseRendererElement.SetResourceStringAsync(String, String, String)
BaseRendererElement.SetResourceStringAsync(String, String)
BaseRendererElement.CompareEventCallbacks<T>(T, T, Dictionary<Type, Dictionary<String, FieldInfo>>)
BaseRendererElement.IgBlazor
BaseRendererElement.IsComponentRooted
BaseRendererElement.ParentTypeName
BaseRendererElement.UseDirectRender
BaseRendererElement.ChildContent
BaseRendererElement.SupportsVisualChildren
BaseRendererElement.Name
BaseRendererElement.Parent
BaseRendererElement.MethodTarget
BaseRendererElement.CurrParent
Namespace: IgniteUI.Blazor.Controls
Assembly: IgniteUI.Blazor.dll
Syntax
public class IgbVirtualDataSource : IgbBaseDataSource, JsonSerializable

Constructors

IgbVirtualDataSource()

Declaration
public IgbVirtualDataSource()

Properties

ActualPageSize

Gets the actual resolved page size that will be used.

Declaration
public int ActualPageSize { get; set; }
Property Value
Type Description
System.Int32

ConcurrencyTag

Gets or sets the field to use for concurrency. I.e. @odata.etag for odata, RowVersion for sql, etc.

Declaration
public string ConcurrencyTag { get; set; }
Property Value
Type Description
System.String

IsBatchingEnabled

Gets whether batch edits are enabled. Setting this property will have no effect.

Declaration
public override bool IsBatchingEnabled { get; set; }
Property Value
Type Description
System.Boolean
Overrides
IgbBaseDataSource.IsBatchingEnabled

IsSectionCollapsable

Declaration
public override bool IsSectionCollapsable { get; set; }
Property Value
Type Description
System.Boolean
Overrides
IgbBaseDataSource.IsSectionCollapsable

IsSectionExpandedDefault

Declaration
public override bool IsSectionExpandedDefault { get; set; }
Property Value
Type Description
System.Boolean
Overrides
IgbBaseDataSource.IsSectionExpandedDefault

MaxCachedPages

Gets or sets the maximum number of data pages to cache in the data source before the oldest pages will start being evicted.

Declaration
public int MaxCachedPages { get; set; }
Property Value
Type Description
System.Int32

PageSizeRequested

Gets or sets the desired page size. This may or may not be respected by the underlying provider, or its connected services.

Declaration
public int PageSizeRequested { get; set; }
Property Value
Type Description
System.Int32

Type

Declaration
public override string Type { get; }
Property Value
Type Description
System.String
Overrides
IgbBaseDataSource.Type

Methods

Clone()

Declaration
public override DataSource Clone()
Returns
Type Description
DataSource
Overrides
IgbBaseDataSource.Clone()

CloneAsync()

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

Declaration
public override Task<DataSource> CloneAsync()
Returns
Type Description
System.Threading.Tasks.Task<DataSource>
Overrides
IgbBaseDataSource.CloneAsync()

CloneProperties(DataSource)

Declaration
public override void CloneProperties(DataSource dataSource)
Parameters
Type Name Description
DataSource dataSource
Overrides
IgbBaseDataSource.CloneProperties(DataSource)

ClonePropertiesAsync(DataSource)

Clones the properties over to the provided datasource.

Declaration
public override Task ClonePropertiesAsync(DataSource dataSource)
Parameters
Type Name Description
DataSource dataSource

The datasource to update.

Returns
Type Description
System.Threading.Tasks.Task
Overrides
IgbBaseDataSource.ClonePropertiesAsync(DataSource)

FindByName(String)

Declaration
public override object FindByName(string name)
Parameters
Type Name Description
System.String name
Returns
Type Description
System.Object
Overrides
IgbBaseDataSource.FindByName(String)

GetIsRowExpandedAtIndex(Int32)

Declaration
public override bool GetIsRowExpandedAtIndex(int rowIndex)
Parameters
Type Name Description
System.Int32 rowIndex
Returns
Type Description
System.Boolean
Overrides
IgbBaseDataSource.GetIsRowExpandedAtIndex(Int32)

GetIsRowExpandedAtIndexAsync(Int32)

Declaration
public override Task<bool> GetIsRowExpandedAtIndexAsync(int rowIndex)
Parameters
Type Name Description
System.Int32 rowIndex
Returns
Type Description
System.Threading.Tasks.Task<System.Boolean>
Overrides
IgbBaseDataSource.GetIsRowExpandedAtIndexAsync(Int32)

GetItemAtIndex(Int32)

Declaration
public override object GetItemAtIndex(int index)
Parameters
Type Name Description
System.Int32 index
Returns
Type Description
System.Object
Overrides
IgbBaseDataSource.GetItemAtIndex(Int32)

GetItemAtIndexAsync(Int32)

Gets the item at the requested index. May return null, in which case you may want to check if that null represents a placeholder for a virtual item.

Declaration
public override Task<object> GetItemAtIndexAsync(int index)
Parameters
Type Name Description
System.Int32 index

The index of the item to retrieve.

Returns
Type Description
System.Threading.Tasks.Task<System.Object>
Overrides
IgbBaseDataSource.GetItemAtIndexAsync(Int32)

GetItemFromKey(Object[])

Declaration
public override object GetItemFromKey(object[] key)
Parameters
Type Name Description
System.Object[] key
Returns
Type Description
System.Object
Overrides
IgbBaseDataSource.GetItemFromKey(Object[])

GetItemFromKeyAsync(Object[])

Declaration
public override Task<object> GetItemFromKeyAsync(object[] key)
Parameters
Type Name Description
System.Object[] key
Returns
Type Description
System.Threading.Tasks.Task<System.Object>
Overrides
IgbBaseDataSource.GetItemFromKeyAsync(Object[])

GetItemPropertyAtIndex(Int32, String)

Declaration
public override object GetItemPropertyAtIndex(int index, string valueName)
Parameters
Type Name Description
System.Int32 index
System.String valueName
Returns
Type Description
System.Object
Overrides
IgbBaseDataSource.GetItemPropertyAtIndex(Int32, String)

GetItemPropertyAtIndexAsync(Int32, String)

Declaration
public override Task<object> GetItemPropertyAtIndexAsync(int index, string valueName)
Parameters
Type Name Description
System.Int32 index
System.String valueName
Returns
Type Description
System.Threading.Tasks.Task<System.Object>
Overrides
IgbBaseDataSource.GetItemPropertyAtIndexAsync(Int32, String)

GetRootSummaryResults()

Declaration
public override IgbDataGridSummaryResult[] GetRootSummaryResults()
Returns
Type Description
IgbDataGridSummaryResult[]
Overrides
IgbBaseDataSource.GetRootSummaryResults()

GetRootSummaryResultsAsync()

Gets the summary results for the root level.

Declaration
public override Task<IgbDataGridSummaryResult[]> GetRootSummaryResultsAsync()
Returns
Type Description
System.Threading.Tasks.Task<IgbDataGridSummaryResult[]>
Overrides
IgbBaseDataSource.GetRootSummaryResultsAsync()

GetRootSummaryRowCount()

Declaration
public override int GetRootSummaryRowCount()
Returns
Type Description
System.Int32
Overrides
IgbBaseDataSource.GetRootSummaryRowCount()

GetRootSummaryRowCountAsync()

Gets the number of summary rows at the root level.

Declaration
public override Task<int> GetRootSummaryRowCountAsync()
Returns
Type Description
System.Threading.Tasks.Task<System.Int32>
Overrides
IgbBaseDataSource.GetRootSummaryRowCountAsync()

GetRowLevel(Int32)

Declaration
public override int GetRowLevel(int rowIndex)
Parameters
Type Name Description
System.Int32 rowIndex
Returns
Type Description
System.Int32
Overrides
IgbBaseDataSource.GetRowLevel(Int32)

GetRowLevelAsync(Int32)

Declaration
public override Task<int> GetRowLevelAsync(int rowIndex)
Parameters
Type Name Description
System.Int32 rowIndex
Returns
Type Description
System.Threading.Tasks.Task<System.Int32>
Overrides
IgbBaseDataSource.GetRowLevelAsync(Int32)

GetRowType(Int32)

Declaration
public override DataSourceRowType GetRowType(int rowIndex)
Parameters
Type Name Description
System.Int32 rowIndex
Returns
Type Description
DataSourceRowType
Overrides
IgbBaseDataSource.GetRowType(Int32)

GetRowTypeAsync(Int32)

Declaration
public override Task<DataSourceRowType> GetRowTypeAsync(int rowIndex)
Parameters
Type Name Description
System.Int32 rowIndex
Returns
Type Description
System.Threading.Tasks.Task<DataSourceRowType>
Overrides
IgbBaseDataSource.GetRowTypeAsync(Int32)

GetSectionSummaryResults(Int32)

Declaration
public override IgbDataGridSummaryResult[][] GetSectionSummaryResults(int sectionIndex)
Parameters
Type Name Description
System.Int32 sectionIndex
Returns
Type Description
IgbDataGridSummaryResult[][]
Overrides
IgbBaseDataSource.GetSectionSummaryResults(Int32)

GetSectionSummaryResultsAsync(Int32)

Gets the summary results for a specific section.

Declaration
public override Task<IgbDataGridSummaryResult[][]> GetSectionSummaryResultsAsync(int sectionIndex)
Parameters
Type Name Description
System.Int32 sectionIndex
Returns
Type Description
System.Threading.Tasks.Task<IgbDataGridSummaryResult[][]>
Overrides
IgbBaseDataSource.GetSectionSummaryResultsAsync(Int32)

GetStickyRowPriority(Int32)

Declaration
public override int GetStickyRowPriority(int row)
Parameters
Type Name Description
System.Int32 row
Returns
Type Description
System.Int32
Overrides
IgbBaseDataSource.GetStickyRowPriority(Int32)

GetStickyRowPriorityAsync(Int32)

Declaration
public override Task<int> GetStickyRowPriorityAsync(int row)
Parameters
Type Name Description
System.Int32 row
Returns
Type Description
System.Threading.Tasks.Task<System.Int32>
Overrides
IgbBaseDataSource.GetStickyRowPriorityAsync(Int32)

GetUnrealizedCount()

Declaration
public virtual int GetUnrealizedCount()
Returns
Type Description
System.Int32

GetUnrealizedCountAsync()

Gets the number of unrealized or virtual items.

Declaration
public virtual Task<int> GetUnrealizedCountAsync()
Returns
Type Description
System.Threading.Tasks.Task<System.Int32>

IndexOfItem(Object)

Declaration
public override int IndexOfItem(object item)
Parameters
Type Name Description
System.Object item
Returns
Type Description
System.Int32
Overrides
IgbBaseDataSource.IndexOfItem(Object)

IndexOfItemAsync(Object)

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.

Declaration
public override Task<int> IndexOfItemAsync(object item)
Parameters
Type Name Description
System.Object item

The item for which to find the index.

Returns
Type Description
System.Threading.Tasks.Task<System.Int32>
Overrides
IgbBaseDataSource.IndexOfItemAsync(Object)

IndexOfKey(Object[])

Declaration
public override int IndexOfKey(object[] key)
Parameters
Type Name Description
System.Object[] key
Returns
Type Description
System.Int32
Overrides
IgbBaseDataSource.IndexOfKey(Object[])

IndexOfKeyAsync(Object[])

Declaration
public override Task<int> IndexOfKeyAsync(object[] key)
Parameters
Type Name Description
System.Object[] key
Returns
Type Description
System.Threading.Tasks.Task<System.Int32>
Overrides
IgbBaseDataSource.IndexOfKeyAsync(Object[])

IsExclusivelySticky(Int32)

Declaration
public override bool IsExclusivelySticky(int row)
Parameters
Type Name Description
System.Int32 row
Returns
Type Description
System.Boolean
Overrides
IgbBaseDataSource.IsExclusivelySticky(Int32)

IsExclusivelyStickyAsync(Int32)

Declaration
public override Task<bool> IsExclusivelyStickyAsync(int row)
Parameters
Type Name Description
System.Int32 row
Returns
Type Description
System.Threading.Tasks.Task<System.Boolean>
Overrides
IgbBaseDataSource.IsExclusivelyStickyAsync(Int32)

IsPlaceholderItem(Int32)

Declaration
public override bool IsPlaceholderItem(int index)
Parameters
Type Name Description
System.Int32 index
Returns
Type Description
System.Boolean
Overrides
IgbBaseDataSource.IsPlaceholderItem(Int32)

IsPlaceholderItemAsync(Int32)

Returns whether the item at the requested index is a placeholder for a virtual item which has yet to be loaded.

Declaration
public override Task<bool> IsPlaceholderItemAsync(int index)
Parameters
Type Name Description
System.Int32 index

The index of the item to check.

Returns
Type Description
System.Threading.Tasks.Task<System.Boolean>
Overrides
IgbBaseDataSource.IsPlaceholderItemAsync(Int32)

IsRowPinned(Int32)

Declaration
public override bool IsRowPinned(int row)
Parameters
Type Name Description
System.Int32 row
Returns
Type Description
System.Boolean
Overrides
IgbBaseDataSource.IsRowPinned(Int32)

IsRowPinnedAsync(Int32)

Declaration
public override Task<bool> IsRowPinnedAsync(int row)
Parameters
Type Name Description
System.Int32 row
Returns
Type Description
System.Threading.Tasks.Task<System.Boolean>
Overrides
IgbBaseDataSource.IsRowPinnedAsync(Int32)

PinRow(Object[])

Declaration
public override void PinRow(object[] key)
Parameters
Type Name Description
System.Object[] key
Overrides
IgbBaseDataSource.PinRow(Object[])

PinRowAsync(Object[])

Declaration
public override Task PinRowAsync(object[] key)
Parameters
Type Name Description
System.Object[] key
Returns
Type Description
System.Threading.Tasks.Task
Overrides
IgbBaseDataSource.PinRowAsync(Object[])

RemoveItemByKey(Object[])

Declaration
public override void RemoveItemByKey(object[] key)
Parameters
Type Name Description
System.Object[] key
Overrides
IgbBaseDataSource.RemoveItemByKey(Object[])

RemoveItemByKeyAsync(Object[])

Declaration
public override Task RemoveItemByKeyAsync(object[] key)
Parameters
Type Name Description
System.Object[] key
Returns
Type Description
System.Threading.Tasks.Task
Overrides
IgbBaseDataSource.RemoveItemByKeyAsync(Object[])

SetIsRowExpandedAtIndex(Int32, Boolean)

Declaration
public override void SetIsRowExpandedAtIndex(int rowIndex, bool isExpanded)
Parameters
Type Name Description
System.Int32 rowIndex
System.Boolean isExpanded
Overrides
IgbBaseDataSource.SetIsRowExpandedAtIndex(Int32, Boolean)

SetIsRowExpandedAtIndexAsync(Int32, Boolean)

Declaration
public override Task SetIsRowExpandedAtIndexAsync(int rowIndex, bool isExpanded)
Parameters
Type Name Description
System.Int32 rowIndex
System.Boolean isExpanded
Returns
Type Description
System.Threading.Tasks.Task
Overrides
IgbBaseDataSource.SetIsRowExpandedAtIndexAsync(Int32, Boolean)

TransformPage(Int32)

Declaration
public int[] TransformPage(int pageIndex)
Parameters
Type Name Description
System.Int32 pageIndex
Returns
Type Description
System.Int32[]

TransformPageAsync(Int32)

Declaration
public Task<int[]> TransformPageAsync(int pageIndex)
Parameters
Type Name Description
System.Int32 pageIndex
Returns
Type Description
System.Threading.Tasks.Task<System.Int32[]>

UnpinRow(Object[])

Declaration
public override void UnpinRow(object[] key)
Parameters
Type Name Description
System.Object[] key
Overrides
IgbBaseDataSource.UnpinRow(Object[])

UnpinRowAsync(Object[])

Declaration
public override Task UnpinRowAsync(object[] key)
Parameters
Type Name Description
System.Object[] key
Returns
Type Description
System.Threading.Tasks.Task
Overrides
IgbBaseDataSource.UnpinRowAsync(Object[])

UpdatePropertyAtKey(Object[], String, Object, Boolean)

Declaration
public override int UpdatePropertyAtKey(object[] key, string propertyPath, object value, bool isPending = false)
Parameters
Type Name Description
System.Object[] key
System.String propertyPath
System.Object value
System.Boolean isPending
Returns
Type Description
System.Int32
Overrides
IgbBaseDataSource.UpdatePropertyAtKey(Object[], String, Object, Boolean)

UpdatePropertyAtKeyAsync(Object[], String, Object, Boolean)

Declaration
public override Task<int> UpdatePropertyAtKeyAsync(object[] key, string propertyPath, object value, bool isPending = false)
Parameters
Type Name Description
System.Object[] key
System.String propertyPath
System.Object value
System.Boolean isPending
Returns
Type Description
System.Threading.Tasks.Task<System.Int32>
Overrides
IgbBaseDataSource.UpdatePropertyAtKeyAsync(Object[], String, Object, Boolean)

Implements

JsonSerializable