XPQueryExtensions.SingleOrDefaultAsync<T>(IQueryable<T>, CancellationToken) Method

Asynchronously gets the only object in a selection. If the selection is empty, returns a default value for <T>. If the selection has more than one element, throws an exception.

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 static Task<T> SingleOrDefaultAsync<T>(
    this IQueryable<T> query,
    CancellationToken cancellationToken = default(CancellationToken)
)

VB.NET

<ExtensionAttribute>
Public Shared Function SingleOrDefaultAsync(Of T)(
    query As IQueryable(Of T),
    cancellationToken As CancellationToken = Nothing
) As Task(Of T)

Parameters

Name	Type	Description
query	IQueryable<T>	An XPQuery<T> that specifies a selection of persistent objects.

Optional Parameters

Name	Type	Default	Description
cancellationToken	CancellationToken	null	A CancellationToken object that delivers a cancellation notice to the running operation.

Type Parameters

Name
T

Returns

Type	Description
Task<T>	A Task that returns the only object in a selection.