IDataAccessAdapterFetchEntityCollection Method (IEntityCollection2, IRelationPredicateBucket, Int32, ISortExpression, IPrefetchPath2, Int32, Int32) |
Fetches one or more entities which match the filter information in the filterBucket into the EntityCollection passed.
The entity collection object has to contain an entity factory object which will be the factory for the entity instances
to be fetched.
It will apply paging and it will from there use a prefetch path fetch using the read page. It's important that pageSize
is smaller than the set ParameterisedPrefetchPathThreshold. It will work, though if pagesize is larger than the limits set for
the ParameterisedPrefetchPathThreshold value, the query is likely to be slower than expected.
Namespace:
SD.LLBLGen.Pro.ORMSupportClasses
Assembly:
SD.LLBLGen.Pro.ORMSupportClasses (in SD.LLBLGen.Pro.ORMSupportClasses.dll) Version: 5.1.0.0 (5.1.0)
Syntax void FetchEntityCollection(
IEntityCollection2 collectionToFill,
IRelationPredicateBucket filterBucket,
int maxNumberOfItemsToReturn,
ISortExpression sortClauses,
IPrefetchPath2 prefetchPath,
int pageNumber,
int pageSize
)
Sub FetchEntityCollection (
collectionToFill As IEntityCollection2,
filterBucket As IRelationPredicateBucket,
maxNumberOfItemsToReturn As Integer,
sortClauses As ISortExpression,
prefetchPath As IPrefetchPath2,
pageNumber As Integer,
pageSize As Integer
)
Parameters
- collectionToFill
- Type: SD.LLBLGen.Pro.ORMSupportClassesIEntityCollection2
EntityCollection object containing an entity factory which has to be filled - filterBucket
- Type: SD.LLBLGen.Pro.ORMSupportClassesIRelationPredicateBucket
filter information for retrieving the entities. If null, all entities are returned of the type created by
the factory in the passed in EntityCollection instance. - maxNumberOfItemsToReturn
- Type: SystemInt32
The maximum amount of entities to return. If 0, all entities matching the filter are returned - sortClauses
- Type: SD.LLBLGen.Pro.ORMSupportClassesISortExpression
SortClause expression which is applied to the query executed, sorting the fetch result. - prefetchPath
- Type: SD.LLBLGen.Pro.ORMSupportClassesIPrefetchPath2
Prefetch path to use. - pageNumber
- Type: SystemInt32
the page number to retrieve. First page is 1. When set to 0, no paging logic is applied - pageSize
- Type: SystemInt32
the size of the page. When set to 0, no paging logic is applied
Exceptions Exception | Condition |
---|
ArgumentException | If the passed in collectionToFill doesn't contain an entity factory. |
See Also