SelfServicingExtensionMethodsGetFirstAsyncTEntity Method (EntityQueryTEntity, ITransaction, CancellationToken)

Async variant of GetFirstTEntity(EntityQueryTEntity, ITransaction). Fetches the first entity of the set returned by the query and returns that entity, if any, otherwise null.

Namespace: SD.LLBLGen.Pro.QuerySpec.SelfServicing
Assembly: SD.LLBLGen.Pro.ORMSupportClasses (in SD.LLBLGen.Pro.ORMSupportClasses.dll) Version: 5.11.0.0 (5.11.23.1114)

Syntax

Copy

public static Task<TEntity> GetFirstAsync<TEntity>(
	this EntityQuery<TEntity> query,
	ITransaction transactionToUse,
	CancellationToken cancellationToken
)
where TEntity : EntityBase, IEntity

<ExtensionAttribute>
Public Shared Function GetFirstAsync(Of TEntity As {EntityBase, IEntity}) ( 
	query As EntityQuery(Of TEntity),
	transactionToUse As ITransaction,
	cancellationToken As CancellationToken
) As Task(Of TEntity)

Parameters

query: Type: SD.LLBLGen.Pro.QuerySpecEntityQueryTEntity
The query.
transactionToUse: Type: SD.LLBLGen.Pro.ORMSupportClassesITransaction
The transaction to use.
cancellationToken: Type: System.ThreadingCancellationToken
The cancellation token.

Type Parameters

TEntity: The type of the entity.

Return Value

Type: TaskTEntity
the first entity in the resultset, or null if the resultset is empty.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type EntityQueryTEntity. 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
ORMQueryConstructionException	The ElementCreator in the query specified is either null or of the wrong type.

Reference

SelfServicingExtensionMethods Class

GetFirstAsync Overload

SD.LLBLGen.Pro.QuerySpec.SelfServicing Namespace