.NET Framework 4.5.2+
.NET Framework 4.5.2+
.NET Standard 2.0+

Session.FindObjectAsync(Type, CriteriaOperator, Boolean, CancellationToken) Method

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

Namespace: DevExpress.Xpo

Assembly: DevExpress.Xpo.v21.2.dll


public Task<object> FindObjectAsync(
    Type classType,
    CriteriaOperator criteria,
    bool selectDeleted,
    CancellationToken cancellationToken = default(CancellationToken)


Name Type Description
classType Type

A Type object which represents the type of objects to search for.

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


A CancellationToken object that delivers a cancellation notice to the running operation.


Type Description

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.


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

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

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.

See Also