Session.FindObjectAsync(PersistentCriteriaEvaluationBehavior, XPClassInfo, CriteriaOperator, 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,
    AsyncFindObjectCallback callback
)

VB.NET

Public Function FindObjectAsync(
    criteriaEvaluationBehavior As PersistentCriteriaEvaluationBehavior,
    classInfo As XPClassInfo,
    criteria As CriteriaOperator,
    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.
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 delegete’s result parameter, or store it for later use within the original thread. Store the exception information passed as delegete’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.