Session.FindObject<ClassType>(PersistentCriteriaEvaluationBehavior, CriteriaOperator) Method

Searches for the first object of the type designated by the specified generic type parameter which 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 ClassType FindObject<ClassType>(
    PersistentCriteriaEvaluationBehavior criteriaEvaluationBehavior,
    CriteriaOperator criteria
)

VB.NET

Public Function FindObject(Of ClassType)(
    criteriaEvaluationBehavior As PersistentCriteriaEvaluationBehavior,
    criteria As CriteriaOperator
) As ClassType

Parameters

Name	Type	Description
criteriaEvaluationBehavior	PersistentCriteriaEvaluationBehavior	A PersistentCriteriaEvaluationBehavior enumeration value that specifies how the persistent criteria is evaluated.
criteria	CriteriaOperator	A CriteriaOperator descendant which represents the criteria to match persistent objects.

Type Parameters

Name	Description
ClassType	The type of objects to search for.

Returns

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

Remarks

Below is an example of using the FindObject<ClassType> method. Here, session is the Session instance.

C#

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

VB.NET

Imports DevExpress.Data.Filtering
Imports DevExpress.Xpo
' ...
Dim personToUpdate As Person = session.FindObject(Of Person)(PersistentCriteriaEvaluationBehavior.BeforeTransaction, _
    CriteriaOperator.Parse("Name='Michael Suyama'"))
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 not included in the search.