IEntityCollection Interface |
Namespace: SD.LLBLGen.Pro.ORMSupportClasses
The IEntityCollection type exposes the following members.
Name | Description | |
---|---|---|
ActiveContext |
Gets / sets the active context this object is in. Setting this property is not adding the object to the context, it will make contained
entities be added to the passed in context. If the object is already in a context, setting this property has no effect.
Setting this property is done by framework code, use the Context's Add/Get methods to work with contexts and entities.
(Inherited from IActiveContextParticipant.) | |
AllowEdit |
Default: true. If set to false, entities inside this collection won't be editable in a complex databinding scenario.
(Inherited from IEntityCollectionCore.) | |
AllowNew |
Default: true. If set to false, no new entities will be added through databinding.
(Inherited from IEntityCollectionCore.) | |
AllowRemove |
Default: false. If set to true, entities can be removed through databinding.
(Inherited from IEntityCollectionCore.) | |
Capacity |
Gets / sets the initial capacity of the entity collection.
| |
ConcurrencyPredicateFactoryToUse |
Gets / sets the IConcurrencyPredicateFactory instance to use when creating entity objects during a GetMulti() call or when AddNew is called.
| |
ContainingEntityMappedField |
Gets the name of the field mapped onto the relation in the opposite entity which is represented by this collection, if this collection is
contained by an entity. E.g. it will return "Customer" if the relation Customer - Order has the field 'Customer' mapped onto it in Order and
this collection is the Orders collection in Customer. If this collection isn't contained in any entity, an empty string is returned.
(Inherited from IEntityCollectionCore.) | |
ContainsDirtyContents |
Returns true if this collection contains dirty objects. If this collection contains dirty objects, an
already filled collection should not be refreshed until a save is performed. This property is calculated in real time
and can be time consuming when the collection contains a lot of objects. Use this property only in cases when the value
of this property is used to do a refetch or not.
| |
Count |
The amount of IEntity2 elements in this entity collection
(Inherited from IEntityCollectionCore.) | |
DefaultView |
Gets the default view for this entitycollection. The returned value is the same instance every time this property is read.
It's a new entity view without a filter or a sorter.
| |
DirtyEntities |
Returns a readonly collection of entities which are flagged as dirty.
This collection is determined on the fly, you can use this collection to remove dirty entities from this entity collection.
| |
DoNotPerformAddIfPresent |
When set to true, an entity passed to Add() or Insert() will be tested if it's already present. If so, the index is returned and the
object is not added again. If set to false (default: true) this check is not performed. Setting this property to true can slow down fetch logic.
DataAccessAdapter's fetch logic sets this property to false during a multi-entity fetch.
| |
EntityFactoryToUse |
The EntityFactory to use when creating entity objects during a GetMulti() call or other logic which requires the creation of new entities.
| |
IsForMN |
Gets or sets a value indicating whether this instance is for a M:N relationship. If set to true, it will also set IsReadOnly to true.
(Inherited from IEntityCollectionCore.) | |
IsReadOnly |
Get / set the readonly flag for this collection.
(Inherited from IEntityCollectionCore.) | |
IsRemovalTracker |
Gets or sets a value indicating whether this instance is a removal tracker collection.
(Inherited from IEntityCollectionCore.) | |
Item |
Gets or sets the IEntity at the specified index.
| |
MaxNumberOfItemsToReturn |
The maximum number of items to return with this retrieval query.
If the used Dynamic Query Engine supports it, 'TOP' is used to limit the amount of rows to return.
When set to 0, no limitations are specified.
| |
RemovedEntitiesTracker |
Gets or sets the entity collection which should be used as removed entities tracker. If this property is set to an IEntityCollection2 instance,
all entities which are removed from this collection are marked for deletion and placed in this removed entities tracker collection.
This collection can then later on be used to delete these entities from the database in one go.
| |
SortClauses |
The order by specifications for the sorting of the resultset. When not specified, no sorting is applied.
| |
SuppressClearInGetMulti |
Surpresses the removal of all contents of the collection in a GetMulti*() call. Used by code in related entities to prevent the removal
of objects when collection properties are accessed.
|
Name | Description | |
---|---|---|
Add(IEntity) |
Adds an IEntity object to the list.
| |
Add(IEntityCore) |
Adds an IEntityCore object to the list.
(Inherited from IEntityCollectionCore.) | |
AddRange |
Adds the range of objects passed in. Objects have to be IEntity implementing objects
| |
Clear |
Clears the collection
(Inherited from IEntityCollectionCore.) | |
Contains(IEntity) |
Returns true if the list contains the given IEntity Object
| |
Contains(IEntityCore) |
Returns true if the list contains the given entity
(Inherited from IEntityCollectionCore.) | |
CopyTo |
copy the complete list of IEntity objects to an array of IEntity objects.
| |
CreateHierarchicalProjection(DictionaryType, IEntityCollection) |
Creates a hierarchical projection of all the data in this collection and for each type in the complete graph found starting with each entity in
this collection. Per entity type found, an entry is stored inside the destination dictionary. It will simply project every data element.
| |
CreateHierarchicalProjection(DataSet) |
Creates a hierarchical projection of all the data in this collection and for each type in the complete graph found starting with each entity in
this collection. Per entity type found, a new datatable is created inside destination or if one with the name of the entity is already present,
that one is used. It will simply project every data element.
| |
CreateHierarchicalProjection(ListIViewProjectionData, DictionaryType, IEntityCollection) |
Creates a hierarchical projection of all the data in this collection and for each type in the complete graph found starting with each entity in this collection,
using the collectionProjections data passed in. Per entity type found, an entry is stored inside the destination dictionary.
| |
CreateHierarchicalProjection(ListIViewProjectionData, DataSet) |
Creates a hierarchical projection of all the data in this collection and for each type in the complete graph found starting with each entity in this
collection, using the collectionProjections data passed in. Per entity type found, a new datatable is created inside destination or if one with
the name of the entity is already present, that one is used.
| |
CreateView |
Creates a new EntityView object of the right type on this collection with no filter nor sorter applied.
| |
CreateView(IPredicate) |
Creates a new EntityView object of the right type on this collection with the passed in filter applied
| |
CreateView(IPredicate, ISortExpression) |
Creates a new EntityView object of the right type on this collection with the passed in filter and sorter applied to it.
| |
CreateView(IPredicate, ISortExpression, PostCollectionChangeAction) |
Creates a new EntityView object of the right type on this collection with the passed in filter and sorter applied to it and the
dataChangeAction set to the passed in value.
| |
DeleteMulti |
Deletes all Entities in the IEntityCollection from the persistent storage. If this IEntityCollection is added
to a transaction, the delete processes will be done in that transaction, if the entity isn't already added to another transaction.
If the entity is already in another transaction, it will use that transaction. If no transaction is present, the deletes are done in a
new Transaction (which is created in an inherited method.)
Deleted entities are marked deleted and are removed from the collection.
| |
DeleteMulti(IPredicate) | Deletes from the persistent storage all entities of the type this collection is for which match with the specified filter,
formulated in the predicate or predicate expression definition. | |
DeleteMulti(IPredicate, IRelationCollection) | Deletes from the persistent storage all entities of the type this collection is for which match with the specified filter,
formulated in the predicate or predicate expression definition. | |
DeleteMultiAsync |
Async variant of DeleteMulti.
Deletes all Entities in the IEntityCollection from the persistent storage. If this IEntityCollection is added
to a transaction, the delete processes will be done in that transaction, if the entity isn't already added to another transaction.
If the entity is already in another transaction, it will use that transaction. If no transaction is present, the deletes are done in a/ new Transaction.
Deleted entities are marked deleted and are removed from the collection.
| |
DeleteMultiAsync(CancellationToken) |
Async variant of DeleteMulti.
Deletes all Entities in the IEntityCollection from the persistent storage. If this IEntityCollection is added
to a transaction, the delete processes will be done in that transaction, if the entity isn't already added to another transaction.
If the entity is already in another transaction, it will use that transaction. If no transaction is present, the deletes are done in a/ new Transaction.
Deleted entities are marked deleted and are removed from the collection.
| |
DeleteMultiAsync(IPredicate) |
Async variant of DeleteMulti(IPredicate).
Deletes from the persistent storage all entities of the type this collection is for which match with the specified filter,
formulated in the predicate or predicate expression definition.
| |
DeleteMultiAsync(IPredicate, IRelationCollection) |
Async variant of DeleteMulti(IPredicate, IRelationCollection).
Deletes from the persistent storage all entities of the type this collection is for which match with the specified filter,
formulated in the predicate or predicate expression definition.
| |
DeleteMultiAsync(IPredicate, CancellationToken) |
Async variant of DeleteMulti(IPredicate).
Deletes from the persistent storage all entities of the type this collection is for which match with the specified filter,
formulated in the predicate or predicate expression definition.
| |
DeleteMultiAsync(IPredicate, IRelationCollection, CancellationToken) |
Async variant of DeleteMulti(IPredicate, IRelationCollection).
Deletes from the persistent storage all entities of the type this collection is for which match with the specified filter,
formulated in the predicate or predicate expression definition.
| |
FetchExcludedFields |
Loads the data for the excluded fields specified in the list of excluded fields into all the entities in this collection.
| |
FetchExcludedFieldsAsync |
Async variant of FetchExcludedFields(ExcludeIncludeFieldsList).
Loads the data for the excluded fields specified in the list of excluded fields into all the entities in this collection.
| |
FindMatches |
Gets all indices of all the entities in the current order of this collection which match the passed in filter.
(Inherited from IEntityCollectionCore.) | |
GetDbCount | Gets the amount of Entity objects in the database. | |
GetDbCount(IPredicate) | Gets the amount of Entity objects in the database, when taking into account the filter specified. | |
GetDbCount(IPredicate, IRelationCollection) | Gets the amount of Entity objects in the database, when taking into account the filter specified and the relations specified. | |
GetEnumerator | Returns an enumerator that iterates through a collection. (Inherited from IEnumerable.) | |
GetMulti(IPredicate) | Retrieves in this Collection object all Entity objects which match with the specified filter, formulated in the predicate or predicate expression definition. | |
GetMulti(IPredicate, IPrefetchPath) | Retrieves in this Collection object all Entity objects which match with the specified filter, formulated in the predicate or predicate expression definition, using the passed in relations to construct the total query. | |
GetMulti(IPredicate, IRelationCollection) | Retrieves in this Collection object all Entity objects which match with the specified filter, formulated in the predicate or predicate expression definition. | |
GetMulti(IPredicate, Int64) | Retrieves in this Collection object all Entity objects which match with the specified filter, formulated in the predicate or predicate expression definition. | |
GetMulti(IPredicate, ExcludeIncludeFieldsList, IPrefetchPath) | Retrieves in this Collection object all Entity objects which match with the specified filter, formulated in the predicate or predicate expression definition, using the passed in relations to construct the total query. | |
GetMulti(IPredicate, ExcludeIncludeFieldsList, Int64) | Retrieves in this Collection object all Entity objects which match with the specified filter, formulated in the predicate or predicate expression definition. | |
GetMulti(IPredicate, Int64, ISortExpression) | Retrieves in this Collection object all Entity objects which match with the specified filter, formulated in the predicate or predicate expression definition. | |
GetMulti(IPredicate, Int64, ISortExpression, IRelationCollection) | Retrieves in this Collection object all Entity objects which match with the specified filter, formulated in the predicate or predicate expression definition. | |
GetMulti(IPredicate, Int64, ISortExpression, IRelationCollection, IPrefetchPath) | Retrieves in this Collection object all Entity objects which match with the specified filter, formulated in the predicate or predicate expression definition, using the passed in relations to construct the total query. | |
GetMulti(IPredicate, Int64, ISortExpression, IRelationCollection, Int32, Int32) | Retrieves in this Collection object all Entity objects which match with the specified filter, formulated in the predicate or predicate expression definition, using the passed in relations to construct the total query. | |
GetMulti(IPredicate, Int64, ISortExpression, IRelationCollection, IPrefetchPath, Int32, Int32) | Retrieves in this Collection object all Entity objects which match with the specified filter, formulated in the predicate or predicate expression definition, using the passed in relations to construct the total query. | |
GetMulti(IPredicate, Int64, ISortExpression, IRelationCollection, IPrefetchPath, ExcludeIncludeFieldsList, Int32, Int32) | Retrieves in this Collection object all Entity objects which match with the specified filter, formulated in the predicate or predicate expression definition, using the passed in relations to construct the total query. | |
IndexOf(IEntity) |
Returns index in the list of given IEntity object.
| |
IndexOf(IEntityCore) |
Returns index in the list of given entity.
(Inherited from IEntityCollectionCore.) | |
Insert(Int32, IEntity) |
Inserts an IEntity on position Index
| |
Insert(Int32, IEntityCore) |
Inserts an IEntityCore on position Index
(Inherited from IEntityCollectionCore.) | |
PerformGetMulti | Retrieves in this Collection object all Entity objects which match with the specified filter, formulated in the predicate or predicate expression definition, using the passed in relations to construct the total query. | |
PerformGetMultiAsync |
Async variant of PerformGetMulti(QueryParameters).
Retrieves in this Collection object all Entity objects which match with the specified filter, formulated in the predicate or predicate expression definition, using the passed in relations to construct the total query.
| |
ReadXml(String) |
Will fill the entity collection and its containing members (recursively) with the data stored in the XmlNode passed in. The XmlNode has to
be filled with Xml in the format written by IEntityCollection.WriteXml() and the Xml has to be compatible with the structure of this entity collection.
| |
ReadXml(XmlNode) |
Will fill the entity collection and its containing members (recursively) with the data stored in the XmlNode passed in. The XmlNode has to
be filled with Xml in the format written by IEntityCollection.WriteXml() and the Xml has to be compatible with the structure of this entity collection.
| |
Remove(IEntity) |
Remove given IEntity from the list.
| |
Remove(IEntityCore) |
Remove given IEntityCore instance from the list.
(Inherited from IEntityCollectionCore.) | |
SaveMulti |
Saves all new/dirty Entities in the IEntityCollection in the persistent storage. If this IEntityCollection is added
to a transaction, the save processes will be done in that transaction, if the entity isn't already added to another transaction.
If the entity is already in another transaction, it will use that transaction. If no transaction is present, the saves are done in a
new Transaction (which is created in an inherited method.). Will not recursively save entities inside the collection.
| |
SaveMulti(Boolean) |
Saves all new/dirty Entities in the IEntityCollection in the persistent storage. If this IEntityCollection is added
to a transaction, the save processes will be done in that transaction, if the entity isn't already added to another transaction.
If the entity is already in another transaction, it will use that transaction. If no transaction is present, the saves are done in a
new Transaction (which is created in an inherited method.)
| |
SaveMultiAsync |
Async variant of SaveMulti.
Saves all new/dirty Entities in the IEntityCollection in the persistent storage. If this IEntityCollection is added
to a transaction, the save processes will be done in that transaction, if the entity isn't already added to another transaction.
If the entity is already in another transaction, it will use that transaction. If no transaction is present, the saves are done in a
new Transaction (which is created in an inherited method.). Will not recursively save entities inside the collection.
| |
SaveMultiAsync(Boolean) |
Async variant of SaveMulti(Boolean).
Saves all new/dirty Entities in the IEntityCollection in the persistent storage. If this IEntityCollection is added to a transaction, the save processes will be done in that transaction, if the entity isn't already added to another transaction.
If the entity is already in another transaction, it will use that transaction. If no transaction is present, the saves are done in a new Transaction (which is created in an inherited method.)
| |
SaveMultiAsync(CancellationToken) |
Async variant of SaveMulti.
Saves all new/dirty Entities in the IEntityCollection in the persistent storage. If this IEntityCollection is added to a transaction, the save processes will be done in that transaction, if the entity isn't already added to another transaction.
If the entity is already in another transaction, it will use that transaction. If no transaction is present, the saves are done in a new Transaction (which is created in an inherited method.)
| |
SaveMultiAsync(Boolean, CancellationToken) |
Async variant of SaveMulti(Boolean).
Saves all new/dirty Entities in the IEntityCollection in the persistent storage. If this IEntityCollection is added to a transaction, the save processes will be done in that transaction, if the entity isn't already added to another transaction.
If the entity is already in another transaction, it will use that transaction. If no transaction is present, the saves are done in a new Transaction (which is created in an inherited method.)
| |
SetContainingEntityInfo |
Sets the entity information of the entity object containing this collection. Call this method only from
entity classes which contain IEntityCollection members, like 'Customer' which contains 'Orders' entity collection.
| |
Sort(Int32, ListSortDirection) |
Applies sorting like IBindingList.ApplySort, on the field with the index fieldIndex and with the direction specified.
(Inherited from IEntityCollectionCore.) | |
Sort(Int32, ListSortDirection, IComparerObject) |
Sorts the collection.
(Inherited from IEntityCollectionCore.) | |
Sort(String, ListSortDirection, IComparerObject) |
Sorts the collection.
(Inherited from IEntityCollectionCore.) | |
UpdateMulti(IEntity, IPredicate) | Updates in the persistent storage all entities of the type this collection is for which have data in common with the specified
entity. Which fields are updated in those matching entities depends on which fields are
changed in entityWithNewValues. The new values of these fields are read from entityWithNewValues. | |
UpdateMulti(IEntity, IPredicate, IRelationCollection) | Updates in the persistent storage all entities of the type this collection is for which have data in common with the specified
entity. Which fields are updated in those matching entities depends on which fields are
changed in entityWithNewValues. The new values of these fields are read from entityWithNewValues. | |
UpdateMultiAsync(IEntity, IPredicate) |
Async variant of UpdateMulti(IEntity, IPredicate).
Updates in the persistent storage all entities of the type this collection is for which have data in common with the specified
entity. Which fields are updated in those matching entities depends on which fields are
changed in entityWithNewValues. The new values of these fields are read from entityWithNewValues.
| |
UpdateMultiAsync(IEntity, IPredicate, IRelationCollection) |
Async variant of UpdateMulti(IEntity, IPredicate, IRelationCollection).
Updates in the persistent storage all entities of the type this collection is for which have data in common with the specified
entity. Which fields are updated in those matching entities depends on which fields are
changed in entityWithNewValues. The new values of these fields are read from entityWithNewValues.
| |
UpdateMultiAsync(IEntity, IPredicate, CancellationToken) |
Async variant of UpdateMulti(IEntity, IPredicate).
Updates in the persistent storage all entities of the type this collection is for which have data in common with the specified
entity. Which fields are updated in those matching entities depends on which fields are
changed in entityWithNewValues. The new values of these fields are read from entityWithNewValues.
| |
UpdateMultiAsync(IEntity, IPredicate, IRelationCollection, CancellationToken) |
Async variant of UpdateMulti(IEntity, IPredicate, IRelationCollection).
Updates in the persistent storage all entities of the type this collection is for which have data in common with the specified
entity. Which fields are updated in those matching entities depends on which fields are
changed in entityWithNewValues. The new values of these fields are read from entityWithNewValues.
| |
WriteXml(String) |
Converts this entity collection to XML, recursively. Uses "EntityCollection" for the rootnode name
| |
WriteXml(String, String) |
Converts this entity collection to XML.
| |
WriteXml(XmlDocument, XmlNode) |
Converts this entity collection to XML. Uses "EntityCollection" for the rootnode name
| |
WriteXml(XmlFormatAspect, String) |
Converts this entity collection to XML, recursively. Uses "EntityCollection" for the rootnode name
| |
WriteXml(String, XmlDocument, XmlNode) |
Converts this entity collection to XML.
| |
WriteXml(XmlFormatAspect, String, String) |
Converts this entity collection to XML.
| |
WriteXml(XmlFormatAspect, XmlDocument, XmlNode) |
Converts this entity collection to XML. Uses "EntityCollection" for the rootnode name
| |
WriteXml(XmlFormatAspect, String, XmlDocument, XmlNode) |
Converts this entity collection to XML.
|
Name | Description | |
---|---|---|
EntityAdded |
Event which is raised at the End of the Add or Insert(index) routine.
(Inherited from IEntityCollectionCore.) | |
EntityAdding |
Event which is raised at the start of the Add or Insert(index) routine. To cancel the addition action, set cancel to true.
(Inherited from IEntityCollectionCore.) | |
EntityRemoved |
Event which is raised at the End of the Remove or RemoveAt(index) routine.
(Inherited from IEntityCollectionCore.) | |
EntityRemoving |
Event which is raised at the start of the Remove or RemoveAt(index) routine. To cancel the remove action, set cancel to true.
(Inherited from IEntityCollectionCore.) | |
ListChanged |
Event which is raised when the collection changed: an item changed, an item was removed, added, or the collection was cleared.
If possible, use one of the Entity* events of this collection.
(Inherited from IEntityCollectionCore.) |
Name | Description | |
---|---|---|
GetMultiTEntity |
Fetches the query specified into the collection specified.
(Defined by SelfServicingExtensionMethods.) | |
GetMultiAsyncTEntity(EntityQueryTEntity) | Overloaded.
Async variant of GetMultiTEntity(IEntityCollection, EntityQueryTEntity).
Fetches the query specified into the collection specified.
(Defined by SelfServicingExtensionMethods.) | |
GetMultiAsyncTEntity(EntityQueryTEntity, CancellationToken) | Overloaded.
Async variant of GetMultiTEntity(IEntityCollection, EntityQueryTEntity).
Fetches the query specified into the collection specified.
(Defined by SelfServicingExtensionMethods.) |