SelfServicingExtensionMethods.GetSingle<TEntity> Method (EntityQuery<TEntity>, ITransaction)

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 TEntity GetSingle<TEntity>(
	this EntityQuery<TEntity> query,
	ITransaction transactionToUse
)
where TEntity : EntityBase, IEntity

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

Parameters

query: Type: SD.LLBLGen.Pro.QuerySpec.EntityQuery<TEntity>
The query.
transactionToUse: Type: SD.LLBLGen.Pro.ORMSupportClasses.ITransaction
The transaction to use.

Type Parameters

TEntity: The type of the entity.

Return Value

Type: 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

GetSingle Overload

SD.LLBLGen.Pro.QuerySpec.SelfServicing Namespace