SelfServicingExtensionMethodsGetSingleAsyncT Method (IDao, DynamicQueryT, ITransaction, CancellationToken)

Async variant of GetSingleT(IDao, DynamicQueryT, ITransaction). Fetches the single object of the set returned by the query and returns that object. 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.5.0.0 (5.5.18.1019)

Syntax

Copy

public static Task<T> GetSingleAsync<T>(
	this IDao dao,
	DynamicQuery<T> query,
	ITransaction transactionToUse,
	CancellationToken cancellationToken
)

<ExtensionAttribute>
Public Shared Function GetSingleAsync(Of T) ( 
	dao As IDao,
	query As DynamicQuery(Of T),
	transactionToUse As ITransaction,
	cancellationToken As CancellationToken
) As Task(Of T)

Parameters

dao: Type: SD.LLBLGen.Pro.ORMSupportClassesIDao
The DAO.
query: Type: SD.LLBLGen.Pro.QuerySpecDynamicQueryT
The query.
transactionToUse: Type: SD.LLBLGen.Pro.ORMSupportClassesITransaction
The transaction to use.
cancellationToken: Type: System.ThreadingCancellationToken
The cancellation token.

Type Parameters

T

Return Value

Type: TaskT
the first object in the resultset

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type IDao. 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
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