Session.PreFetchAsync<T>(IEnumerable<T>, String, IEnumerable, CancellationToken) Method
Asynchronously forces associated collection data loading for specified parent objects.
Namespace: DevExpress.Xpo
Assembly: DevExpress.Xpo.v18.2.dll
Declaration
public Task PreFetchAsync<T>(
IEnumerable<T> objects,
string collectionInObjects,
IEnumerable collectionsContent,
CancellationToken cancellationToken
)
Parameters
Name | Type | Description |
---|---|---|
objects | IEnumerable<T> | An IEnumerable list of parent objects. |
collectionInObjects | String | A string which is the name of the associated collection property. |
collectionsContent | IEnumerable | An IEnumerable list of the collection’s content. If a certain part of the collectionInObjects data was previously loaded, you can avoid reloading it by passing the loaded data to the collectionsContent parameter. |
cancellationToken | CancellationToken | A CancellationToken object that delivers a cancellation notice to the running operation. |
Type Parameters
Name |
---|
T |
Returns
Type | Description |
---|---|
Task | A Task that forces associated collection data loading for specified parent objects. |
Remarks
By default, data is loaded automatically when you access a nested collection for the first time. The PreFetchAsync<T> method loads required associated collection data for a parent object at once. No additional SQL queries for this data will be will be performed later.