InfiniteSource Class
The infinite source. This source is obsolete. Use the InfiniteAsyncSource instead.
Namespace: DevExpress.Xpf.Data
Assembly: DevExpress.Xpf.Core.v20.2.dll
NuGet Packages: DevExpress.WindowsDesktop.Wpf.Core, DevExpress.Wpf.Core
Declaration
Remarks
Refer to the Virtual Sources Overview topic to learn more.
Important
The InfiniteSource is obsolete. Use the InfiniteAsyncSource instead.
Examples
- How to Bind to InfiniteSource - demonstrates how to bind the GridControl to InfiniteSource.
- How to Use InfiniteAsyncSource In Single Thread - demonstrates how to use InfiniteAsyncSource in a single thread.
Workflow
The InfiniteSource raises events consecutively in the UI Thread and processes data in a single separate Working Thread.
- The InfiniteSource creates a single separate Working Thread to process data.
- The InfiniteSource raises the InfiniteSource.CreateSource event. Handle this event to create an object used to request data (for example, DbContext for EF, UnitOfWork for XPO).
- (Optional step) The InfiniteSource raises the InfiniteSource.GetTotalSummaries event. Handle this event and process summaries if you want to show them in the GridControl.
- The InfiniteSource raises the InfiniteSource.FetchRows event to get the first portion of data.
- When users navigate to the next page, the InfiniteSource raises the InfiniteSource.FetchRows event to get the next portion of data.
- (Optional step) When end users apply a filter, the InfiniteSource raises the InfiniteSource.GetUniqueValues event to get unique values and show them in a drop-down filter.
Note
Only values of the Char, SByte, Byte, Int16, UInt16, Int32, UInt32, Int64, UInt64, Single, Double, Decimal, DateTime, String, Guid, Enum types are available in the UI Thread.
For other types, the UI Thread creates thread-safe proxy objects. You can allow access to these values in the following ways:
- Specify the VirtualSourceBase.CustomProperties, or
- Set the InfiniteSource.AreSourceRowsThreadSafe property to true.