Click or drag to resize
IEntityCollection2 Interface
Interface for the EntityCollection2 type. The collection defines typed basic collection behavior. Adapter specific

Namespace:  SD.LLBLGen.Pro.ORMSupportClasses
Assembly:  SD.LLBLGen.Pro.ORMSupportClasses (in SD.LLBLGen.Pro.ORMSupportClasses.dll) Version: 5.3.0.0 (5.3.0)
Syntax
public interface IEntityCollection2 : IEntityCollectionCore, 
	IActiveContextParticipant, IEnumerable

The IEntityCollection2 type exposes the following members.

Properties
  NameDescription
Public propertyActiveContext
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.)
Public propertyAllowEdit
Default: true. If set to false, entities inside this collection won't be editable in a complex databinding scenario.
(Inherited from IEntityCollectionCore.)
Public propertyAllowNew
Default: true. If set to false, no new entities will be added through databinding.
(Inherited from IEntityCollectionCore.)
Public propertyAllowRemove
Default: false. If set to true, entities can be removed through databinding.
(Inherited from IEntityCollectionCore.)
Public propertyCapacity
Gets / sets the initial capacity of the entity collection.
Public propertyConcurrencyPredicateFactoryToUse
Gets / sets the IConcurrencyPredicateFactory instance to use when creating entity objects during an entity collection fetch
Public propertyContainingEntityMappedField
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.)
Public propertyContainsDirtyContents
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.
Public propertyCount
The amount of IEntity2 elements in this entity collection
(Inherited from IEntityCollectionCore.)
Public propertyDefaultView
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.
Public propertyDirtyEntities
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.
Public propertyDoNotPerformAddIfPresent
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.
Public propertyEntityFactoryToUse
The EntityFactory2 to use when creating entity objects when bound to a control and AddNew is enabled.
Public propertyIsForMN
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.)
Public propertyIsReadOnly
Get / set the readonly flag for this collection.
(Inherited from IEntityCollectionCore.)
Public propertyIsRemovalTracker
Gets or sets a value indicating whether this instance is a removal tracker collection.
(Inherited from IEntityCollectionCore.)
Public propertyItem
Simple indexer.
Public propertyRemovedEntitiesTracker
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.
Top
Methods
  NameDescription
Public methodAdd(IEntity2)
Adds an IEntity2 object to the list.
Public methodAdd(IEntityCore)
Adds an IEntityCore object to the list.
(Inherited from IEntityCollectionCore.)
Public methodAddRange
Adds the range of objects passed in. Objects have to be IEntity2 implementing objects
Public methodClear
Clears the collection
(Inherited from IEntityCollectionCore.)
Public methodContains(IEntity2)
Returns true if the list contains the given IEntity2 Object
Public methodContains(IEntityCore)
Returns true if the list contains the given entity
(Inherited from IEntityCollectionCore.)
Public methodCopyTo
copy the complete list of IEntity2 objects to an array of IEntity objects.
Public methodCreateHierarchicalProjection(DictionaryType, IEntityCollection2)
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.
Public methodCreateHierarchicalProjection(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.
Public methodCreateHierarchicalProjection(ListIViewProjectionData, DictionaryType, IEntityCollection2)
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.
Public methodCreateHierarchicalProjection(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.
Public methodCreateView
Creates a new EntityView2 object of the right type on this collection with no filter nor sorter applied.
Public methodCreateView(IPredicate)
Creates a new EntityView2 object of the right type on this collection with the passed in filter applied
Public methodCreateView(IPredicate, ISortExpression)
Creates a new EntityView2 object of the right type on this collection with the passed in filter and sorter applied to it.
Public methodCreateView(IPredicate, ISortExpression, PostCollectionChangeAction)
Creates a new EntityView2 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.
Public methodFindMatches
Gets all indices of all the entities in the current order of this collection which match the passed in filter.
(Inherited from IEntityCollectionCore.)
Public methodGetEnumerator
Returns an enumerator that iterates through a collection.
(Inherited from IEnumerable.)
Public methodIndexOf(IEntity2)
Returns index in the list of given IEntity2 object.
Public methodIndexOf(IEntityCore)
Returns index in the list of given entity.
(Inherited from IEntityCollectionCore.)
Public methodInsert(Int32, IEntity2)
Inserts an IEntity2 on position Index
Public methodInsert(Int32, IEntityCore)
Inserts an IEntityCore on position Index
(Inherited from IEntityCollectionCore.)
Public methodReadXml(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 IEntityCollection2.WriteXml() and the Xml has to be compatible with the structure of this entity collection.
Public methodReadXml(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 IEntityCollection2.WriteXml() and the Xml has to be compatible with the structure of this entity collection.
Public methodRemove(IEntity2)
Remove given IEntity2 instance from the list.
Public methodRemove(IEntityCore)
Remove given IEntityCore instance from the list.
(Inherited from IEntityCollectionCore.)
Public methodRemoveAt
Removes the IEntity instance at the index given.
Public methodSetContainingEntityInfo
Sets the entity information of the entity object containing this collection. Call this method only from entity classes which contain EntityCollection members, like 'Customer' which contains 'Orders' entity collection.
Public methodSort(Int32, ListSortDirection)
Applies sorting like IBindingList.ApplySort, on the field with the index fieldIndex and with the direction specified.
(Inherited from IEntityCollectionCore.)
Public methodSort(Int32, ListSortDirection, IComparerObject)
Sorts the collection.
(Inherited from IEntityCollectionCore.)
Public methodSort(String, ListSortDirection, IComparerObject)
Sorts the collection.
(Inherited from IEntityCollectionCore.)
Public methodWriteXml(String)
Converts this entity collection to XML, recursively. Uses "EntityCollection" for the rootnode name
Public methodWriteXml(String, String)
Converts this entity collection to XML.
Public methodWriteXml(XmlDocument, XmlNode)
Converts this entity collection to XML. Uses "EntityCollection" for the rootnode name
Public methodWriteXml(XmlWriter, XmlFormatAspect)
Converts this entity collection to XML
Public methodWriteXml(XmlFormatAspect, String)
Converts this entity collection to XML, recursively. Uses "EntityCollection" for the rootnode name
Public methodWriteXml(String, XmlDocument, XmlNode)
Converts this entity collection to XML.
Public methodWriteXml(XmlWriter, XmlFormatAspect, String)
Converts this entity collection to XML
Public methodWriteXml(XmlFormatAspect, String, String)
Converts this entity collection to XML.
Public methodWriteXml(XmlFormatAspect, XmlDocument, XmlNode)
Converts this entity collection to XML. Uses "EntityCollection" for the rootnode name
Public methodWriteXml(XmlFormatAspect, String, XmlDocument, XmlNode)
Converts this entity collection to XML.
Top
Events
  NameDescription
Public eventEntityAdded
Event which is raised at the End of the Add or Insert(index) routine.
(Inherited from IEntityCollectionCore.)
Public eventEntityAdding
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.)
Public eventEntityRemoved
Event which is raised at the End of the Remove or RemoveAt(index) routine.
(Inherited from IEntityCollectionCore.)
Public eventEntityRemoving
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.)
Public eventListChanged
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.)
Top
See Also