Session.SelectDataInTransactionAsync(XPClassInfo, CriteriaOperatorCollection, CriteriaOperator, CriteriaOperatorCollection, CriteriaOperator, Boolean, Int32, Int32, SortingCollection, CancellationToken) Method
Asynchronously retrieves objects from a session, according to specified query parameters. Accounts for all in-memory object changes.
Namespace: DevExpress.Xpo
Assembly: DevExpress.Xpo.v24.1.dll
NuGet Packages: DevExpress.Win.PivotGrid, DevExpress.Win.TreeMap, DevExpress.Xpo
NuGet Package: DevExpress.Xpo
Declaration
public Task<List<object[]>> SelectDataInTransactionAsync(
XPClassInfo classInfo,
CriteriaOperatorCollection properties,
CriteriaOperator criteria,
CriteriaOperatorCollection groupProperties,
CriteriaOperator groupCriteria,
bool selectDeleted,
int skipSelectedRecords,
int topSelectedRecords,
SortingCollection sorting,
CancellationToken cancellationToken = default(CancellationToken)
)
Parameters
Name | Type | Description |
---|---|---|
classInfo | XPClassInfo | An XPClassInfo object that contains metadata information. This data specifies which objects need to be retrieved. |
properties | CriteriaOperatorCollection | A CriteriaOperatorCollection object which specifies object properties to be retrieved. |
criteria | CriteriaOperator | A CriteriaOperator descendant which specifies the objects to be retrieved. |
groupProperties | CriteriaOperatorCollection | A CriteriaOperatorCollection object which specifies the grouping properties. |
groupCriteria | CriteriaOperator | A CriteriaOperator descendant which specifies the grouping criteria for the retrieved objects. |
selectDeleted | Boolean | A Boolean value that specifies whether the objects marked as deleted must be retrieved. |
skipSelectedRecords | Int32 | An integer value which specifies the number of objects to exclude when populating the list. |
topSelectedRecords | Int32 | An integer value which specifies the maximum number of objects to be retrieved. |
sorting | SortingCollection | A SortingCollection object that specifies the sort order for the list of the retrieved objects. |
Optional Parameters
Name | Type | Default | Description |
---|---|---|---|
cancellationToken | CancellationToken | null | A CancellationToken object that delivers a cancellation notice to the running operation. |
Returns
Type | Description |
---|---|
Task<List<Object[]>> | A Task that returns a list of object arrays. These object arrays represent object properties retrieved from a session. |
Remarks
This method is intended for internal use. To include in-memory changes into query results, get objects from a session using the XPCollection and XPView components with the Session.InTransactionMode enabled.