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

Asynchronously searches for the first object that matches the specified criteria.

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 Task<object> FindObjectAsync(
    PersistentCriteriaEvaluationBehavior criteriaEvaluationBehavior,
    XPClassInfo classInfo,
    CriteriaOperator criteria,
    bool selectDeleted,
    CancellationToken cancellationToken = default(CancellationToken)
)

VB.NET

Public Function FindObjectAsync(
    criteriaEvaluationBehavior As PersistentCriteriaEvaluationBehavior,
    classInfo As XPClassInfo,
    criteria As CriteriaOperator,
    selectDeleted As Boolean,
    cancellationToken As CancellationToken = Nothing
) As Task(Of 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. This data specifies which class needs to be searched.
criteria	CriteriaOperator	A CriteriaOperator descendant which represents the criteria the persistent object must match.
selectDeleted	Boolean	true, to include persistent objects marked as deleted into the search; otherwise, false.

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<Object>	A Task that returns an object. This object represents the first persistent object that matches the specified criteria. null (Nothing in Visual Basic) if no persistent object is found that matches the criteria.

Remarks

The example below demonstrates how to use this method. Here, session is the Session instance.

C#

using System.Threading;
using DevExpress.Data.Filtering;
using DevExpress.Xpo;
using DevExpress.Xpo.Metadata;
// ...
CancellationTokenSource source = new CancellationTokenSource();
CancellationToken cancellationToken = source.Token;
XPClassInfo personClassInfo = session.GetClassInfo(typeof(Person));
Person personToUpdate = 
    (Person)await session.FindObjectAsync(PersistentCriteriaEvaluationBehavior.BeforeTransaction, 
    personClassInfo, CriteriaOperator.Parse("Name='Michael Suyama'"), true, cancellationToken);
if(personToUpdate != null) {
    personToUpdate.Birthday = new DateTime(1986, 10, 31);
    session.Save(personToUpdate);
}

VB.NET

Imports System.Threading
Imports DevExpress.Data.Filtering
Imports DevExpress.Xpo
Imports DevExpress.Xpo.Metadata
' ...
Private source As New CancellationTokenSource()
Private cancellationToken As CancellationToken = source.Token
Private personClassInfo As XPClassInfo = session.GetClassInfo(GetType(Person))
Private personToUpdate As Person = _
    CType(Await session.FindObjectAsync(PersistentCriteriaEvaluationBehavior.BeforeTransaction, _
    personClassInfo, CriteriaOperator.Parse("Name='Michael Suyama'"), True, cancellationToken), Person)
If personToUpdate IsNot Nothing Then
    personToUpdate.Birthday = New Date(1986, 10, 31)
    session.Save(personToUpdate)
End If

Persistent objects that are marked as deleted in the database (see Deferred and Immediate Object Deletion) are can be optionally included in the search using the selectDeleted parameter.