Session.FindObjectAsync(PersistentCriteriaEvaluationBehavior, XPClassInfo, CriteriaOperator, Boolean, AsyncFindObjectCallback) Method

Asynchronously searches for the first object which matches the specified criteria, and notifies upon completion.

Namespace: DevExpress.Xpo

Assembly: DevExpress.Xpo.v24.1.dll

NuGet Packages: DevExpress.Win.PivotGrid, DevExpress.Win.TreeMap, DevExpress.Xpo

NuGet Package: DevExpress.Xpo

Declaration

C#

public object FindObjectAsync(
    PersistentCriteriaEvaluationBehavior criteriaEvaluationBehavior,
    XPClassInfo classInfo,
    CriteriaOperator criteria,
    bool selectDeleted,
    AsyncFindObjectCallback callback
)

VB.NET

Public Function FindObjectAsync(
    criteriaEvaluationBehavior As PersistentCriteriaEvaluationBehavior,
    classInfo As XPClassInfo,
    criteria As CriteriaOperator,
    selectDeleted As Boolean,
    callback As AsyncFindObjectCallback
) As Object

Parameters

Name	Type	Description
criteriaEvaluationBehavior	PersistentCriteriaEvaluationBehavior	A PersistentCriteriaEvaluationBehavior enumeration value that specifies how the persistent criteria is evaluated.
classInfo	XPClassInfo	An XPClassInfo object which contains the metadata information of the class.
criteria	CriteriaOperator	A CriteriaOperator descendant which represents the criteria to match persistent objects.
selectDeleted	Boolean	true to include persistent objects marked for deletion into the search; otherwise, false.
callback	DevExpress.Xpo.Helpers.AsyncFindObjectCallback	A DevExpress.Xpo.Helpers.AsyncFindObjectCallback delegate to be called after the method completes. Use callback to do the following: Access the found object passed as the delegate’s result parameter, or store it for later use within the original thread. Store the exception information passed as delegate’s ex parameter, and use this information later to raise the exception again, within the original thread. Do not raise exceptions or modify persistent objects within a callback.

Returns

Type	Description
Object	An object used internally to manage an asynchronous operation.

Remarks

We recommend using the FindObjectAsync(PersistentCriteriaEvaluationBehavior, XPClassInfo, CriteriaOperator, Boolean, AsyncFindObjectCallback) Task-based overload instead of this method.