SelfServicingExtensionMethods.GetSingleAsync<TEntity> Method (EntityQuery<TEntity>)

Async variant of GetSingle<TEntity>(EntityQuery<TEntity>). Fetches the single entity of the set returned by the query and returns that entity. If there are no elements or more than 1 element, a NotSupportedException will be thrown.

Namespace: SD.LLBLGen.Pro.QuerySpec.SelfServicing
Assembly: SD.LLBLGen.Pro.ORMSupportClasses (in SD.LLBLGen.Pro.ORMSupportClasses.dll) Version: 5.4.0.0 (5.4.0)

Syntax

Copy

public static Task<TEntity> GetSingleAsync<TEntity>(
	this EntityQuery<TEntity> query
)
where TEntity : EntityBase, IEntity

<ExtensionAttribute>
Public Shared Function GetSingleAsync(Of TEntity As {EntityBase, IEntity}) ( 
	query As EntityQuery(Of TEntity)
) As Task(Of TEntity)

Parameters

query: Type: SD.LLBLGen.Pro.QuerySpec.EntityQuery<TEntity>
The query.

Type Parameters

TEntity: The type of the entity.

Return Value

Type: Task<TEntity>
the first entity in the resultset

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type EntityQuery<TEntity>. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Exceptions

Exception	Condition
NotSupportedException	Thrown if the resultset has 0 or 2 or more elements, as Single requires a single value in the resultset.

Reference

SelfServicingExtensionMethods Class

GetSingleAsync Overload

SD.LLBLGen.Pro.QuerySpec.SelfServicing Namespace