SelfServicingExtensionMethodsGetSingleTEntity Method (EntityQueryTEntity, 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 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.QuerySpecEntityQueryTEntity
The query. - transactionToUse
- Type: SD.LLBLGen.Pro.ORMSupportClassesITransaction
The transaction to use.
Type Parameters
- TEntity
- The type of the entity.
Return Value
Type:
TEntitythe 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
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 |
---|
NotSupportedException | Thrown if the resultset has 0 or 2 or more elements, as Single requires a single value in the resultset. |
See Also