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.FindObjectAsync(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.v19.2.dll

Declaration

public object FindObjectAsync(
    XPClassInfo classInfo,
    CriteriaOperator criteria,
    AsyncFindObjectCallback callback
)
Public Function FindObjectAsync(
    classInfo As XPClassInfo,
    criteria As CriteriaOperator,
    callback As AsyncFindObjectCallback
) As Object
public object FindObjectAsync(
    XPClassInfo classInfo,
    CriteriaOperator criteria,
    AsyncFindObjectCallback callback
)
Public Function FindObjectAsync(
    classInfo As XPClassInfo,
    criteria As CriteriaOperator,
    callback As AsyncFindObjectCallback
) As Object

Parameters

Name Type Description
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 delegate's result parameter, or store it for later use within the original thread.
  • Store the exception information passed as delegate'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.

Parameters

Name Type Description
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 delegate's result parameter, or store it for later use within the original thread.
  • Store the exception information passed as delegate'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.

Returns

Type Description
Object

An object used internally to manage an asynchronous operation.

Remarks

We recommend using the FindObjectAsync(XPClassInfo, CriteriaOperator, CancellationToken) Task-based overload instead of this method.

See Also