AdapterExtensionMethodsFetchSingleTEntity Method (IDataAccessAdapter, EntityQueryTEntity)

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.Adapter
Assembly: SD.LLBLGen.Pro.ORMSupportClasses (in SD.LLBLGen.Pro.ORMSupportClasses.dll) Version: 5.6.0.0 (5.6.19.0117)

Syntax

Copy

public static TEntity FetchSingle<TEntity>(
	this IDataAccessAdapter adapter,
	EntityQuery<TEntity> query
)
where TEntity : EntityBase2, IEntity2

<ExtensionAttribute>
Public Shared Function FetchSingle(Of TEntity As {EntityBase2, IEntity2}) ( 
	adapter As IDataAccessAdapter,
	query As EntityQuery(Of TEntity)
) As TEntity

Parameters

adapter: Type: SD.LLBLGen.Pro.ORMSupportClassesIDataAccessAdapter
The adapter.
query: Type: SD.LLBLGen.Pro.QuerySpecEntityQueryTEntity
The query.

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 IDataAccessAdapter. 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

AdapterExtensionMethods Class

FetchSingle Overload

SD.LLBLGen.Pro.QuerySpec.Adapter Namespace