The requested page is not available for the requested platform. You are viewing the content for .NET Framework 4.5.2+ platform.
.NET Framework 4.5.2+
.NET Framework 4.5.2+
.NET Standard 2.0+

Session.FindObject(Type, CriteriaOperator, Boolean) Method

Searches for the first object which matches the specified criteria.

Namespace: DevExpress.Xpo

Assembly: DevExpress.Xpo.v19.2.dll

Declaration

public object FindObject(
    Type classType,
    CriteriaOperator criteria,
    bool selectDeleted
)
Public Function FindObject(
    classType As Type,
    criteria As CriteriaOperator,
    selectDeleted As Boolean
) As Object
public object FindObject(
    Type classType,
    CriteriaOperator criteria,
    bool selectDeleted
)
Public Function FindObject(
    classType As Type,
    criteria As CriteriaOperator,
    selectDeleted As Boolean
) As Object

Parameters

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 to match persistent objects to.

selectDeleted Boolean

true to include persistent objects marked as deleted into the search; otherwise, false.

Parameters

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 to match persistent objects to.

selectDeleted Boolean

true to include persistent objects marked as deleted into the search; otherwise, false.

Returns

Type Description
Object

An object which represents the first persistent object which matches the specified criteria. null (Nothing in Visual Basic) if no persistent object which matches the criteria is found.

Returns

Type Description
Object

An object which represents the first persistent object which matches the specified criteria. null (Nothing in Visual Basic) if no persistent object which matches the criteria is found.

Remarks

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

using DevExpress.Data.Filtering;
using DevExpress.Xpo;
// ...
Person personToUpdate = (Person)session.FindObject(typeof(Person), 
    CriteriaOperator.Parse("Name='Michael Suyama'"), true);
if(personToUpdate != null) {
    personToUpdate.Birthday = new DateTime(1986, 10, 31);
    session.Save(personToUpdate);
}

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