Click or drag to resize
IEntity Methods

The IEntity type exposes the following members.

Methods
  NameDescription
Public methodAcceptChanges
Accepts the changes made to the fields. Used in databinding/service scenarios. Calls AcceptChange on the fields in this entity
(Inherited from IEntityCore.)
Public methodBeginEdit
Begins an edit on an object.
(Inherited from IEditableObject.)
Public methodCancelEdit (Inherited from IEditableObject.)
Public methodCheckIfEntityHasPendingFkSyncsTEntity
Checks whether this instance has pending fk syncs. A pending FK sync is a sync which hasn't been used yet. If an entity has pending FK syncs, it has to be included into a save queue. Only syncs with entities in the passed in queue are considered. If a sync is with an entity which isn't in the passed in queue, the sync isn't honoured anyway, so the fk sync can be ignored.
(Inherited from IEntityCore.)
Public methodCheckIfIsSubTypeOf
Determines whether this entity is a subType of the entity represented by the passed in enum value, which represents a value in the EntityType enum
(Inherited from IEntityCore.)
Public methodDelete
Deletes the Entity from the persistent storage. This method succeeds also when the Entity is not present. Uses, if applicable, the ConcurrencyPredicateFactory to supply the predicate to limit delete activity.
Public methodDelete(IPredicate)
Deletes the Entity from the persistent storage. This method succeeds also when the Entity is not present.
Public methodDeleteAsync
Async variant of Delete. Deletes the Entity from the persistent storage. This method succeeds also when the Entity is not present.
Public methodDeleteAsync(CancellationToken)
Async variant of Delete. Deletes the Entity from the persistent storage. This method succeeds also when the Entity is not present.
Public methodDeleteAsync(IPredicate)
Async variant of Delete(IPredicate). Deletes the Entity from the persistent storage. This method succeeds also when the Entity is not present.
Public methodDeleteAsync(IPredicate, CancellationToken)
Async variant of Delete(IPredicate). Deletes the Entity from the persistent storage. This method succeeds also when the Entity is not present.
Public methodDiscardSavedFields
Removes all saved field sets from the internal hashtable, clearing up space. This method is also called when an entity is saved.
(Inherited from IEntityCore.)
Public methodEndEdit (Inherited from IEditableObject.)
Public methodFetchExcludedFields
Loads the data for the excluded fields specified in the list of excluded fields into this entity.
Public methodFlagAsSaved
Method which will fire the AfterSave event to signal that this entity is persisted and refetched succesfully.
(Inherited from IEntityCore.)
Public methodFlagMeAsChanged
Routine which will flag all subscribers of the EntityContentsChanged event that this entity's contents is changed.
(Inherited from IEntityCore.)
Public methodGetAllRelations
Gets a list of all the EntityRelation objects the type of this instance has.
(Inherited from IEntityCore.)
Public methodGetConcurrencyPredicate
Creates the requested predicate of the type specified. If no IConcurrencyPredicateFactory instance is stored in this entity instance, null is returned.
(Inherited from IEntityCore.)
Public methodGetCurrentFieldValue
Gets the current value of the EntityField with the index fieldIndex. Will refetch the complete entity's fields from the database if necessary (i.e. the entity is outofsync.).
(Inherited from IEntityCore.)
Public methodGetDependentRelatedEntities
Gets a collection of related entities referenced by this entity which this entity depends on (this entity is the FK side of their PK fields). These entities will have to be persisted before this entity during a recursive save.
Public methodGetDependingRelatedEntities
Gets a collection of related entities referenced by this entity which depend on this entity (this entity is the PK side of their FK fields). These entities will have to be persisted after this entity during a recursive save.
Public methodGetEntityDescription(Boolean)
Gets the entity description. This string is used in verbose trace messages. It will produce "EntityCore", if the passed in switch flag is false, to prevent performance loss due to reflection activity for trace results which will never be seen.
(Inherited from IEntityCore.)
Public methodGetEntityDescription(Boolean, IEntityCore)
Gets the entity description. This string is used in verbose trace messages. It will produce "EntityCore", if verbose tracing is switched off for the GeneralSwitch, to prevent performance loss due to reflection activity for trace results which will never be seen.
(Inherited from IEntityCore.)
Public methodGetEntityFactory
Returns a new ready to use factory for the type of this instance.
Public methodGetFieldByName
Helper method which performs a lookup in the fields based on the name specified.
(Inherited from IEntityCore.)
Public methodGetInheritanceInfo
Gets the inheritance info for this entity, if applicable (it's then overriden) or null if not.
(Inherited from IEntityCore.)
Public methodGetInheritanceInfoProvider
Gets the inheritance info provider instance of the project this entity instance is located in.
(Inherited from IEntityCore.)
Public methodGetMemberEntityCollections
Gets a list of all entity collections stored as member variables in this entity. The contents of the list is used by the Save logic to perform recursive saves. Only 1:n related collections are returned.
Public methodGetRelatedData
Gets all related data objects, stored by name. The name is the field name mapped onto the relation for that particular data element.
(Inherited from IEntityCore.)
Public methodGetRelationsForFieldOfType
Gets the relation objects which represent the relation the fieldName specified is mapped on.
(Inherited from IEntityCore.)
Public methodReadXml(String)
Will fill the entity and its containing members (recursively) with the data stored in the Xml string passed in. The string xmlData has to be filled with Xml in the format written by IEntity.WriteXml() and the Xml has to be compatible with the structure of this entity.
(Inherited from IEntityCore.)
Public methodReadXml(XmlNode)
Will fill the entity 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 IEntity.WriteXml() and the Xml has to be compatible with the structure of this entity.
(Inherited from IEntityCore.)
Public methodRefetch
Refetches the Entity from the persistent storage. Refetch is used to re-load an Entity which is marked "Out-of-sync", due to a save action. Refetching an empty Entity has no effect.
Public methodRejectChanges
Rejects the changes made to the fields. Used in databinding/service scenarios. Calls RejectChange on the fields in this entity
(Inherited from IEntityCore.)
Public methodRollbackFields
Replaces the current set of fields with the fields saved under the name specified. If no set of fields is found with the name specified an exception is thrown. Removes the entry after a succesful rollback.
(Inherited from IEntityCore.)
Public methodSave
Saves the Entity class to the persistent storage. It updates or inserts the entity, which depends if the entity was originally read from the database. Will not recursively save internal dirty entities. Uses, if applicable, the ConcurrencyPredicateFactory to supply the predicate to limit save activity.
Public methodSave(Boolean)
Saves the Entity class to the persistent storage. It updates or inserts the entity, which depends if the entity was originally read from the database. Uses, if applicable, the ConcurrencyPredicateFactory to supply the predicate to limit save activity.
Public methodSave(IPredicate)
Saves the Entity class to the persistent storage. It updates or inserts the entity, which depends if the entity was originally read from the database. If the entity is new, an insert is done and the updateRestriction is ignored. If the entity is not new, the updateRestriction predicate is used to create an additional where clause (it will be added with AND) for the update query. This predicate can be used for concurrency checks, like checks on timestamp column values. Will not recursively save internal dirty entities.
Public methodSave(IPredicate, Boolean)
Saves the Entity class to the persistent storage. It updates or inserts the entity, which depends if the entity was originally read from the database. If the entity is new, an insert is done and the updateRestriction is ignored. If the entity is not new, the updateRestriction predicate is used to create an additional where clause (it will be added with AND) for the update query. This predicate can be used for concurrency checks, like checks on timestamp column values.
Public methodSaveAsync
Async variant of Save Saves the Entity class to the persistent storage. It updates or inserts the entity, which depends if the entity was originally read from the database. If the entity is new, an insert is done and the updateRestriction is ignored. If the entity is not new, the updateRestriction predicate is used to create an additional where clause (it will be added with AND) for the update query. This predicate can be used for concurrency checks, like checks on timestamp column values.
Public methodSaveAsync(Boolean)
Async variant of Save(Boolean) Saves the Entity class to the persistent storage. It updates or inserts the entity, which depends if the entity was originally read from the database. If the entity is new, an insert is done and the updateRestriction is ignored. If the entity is not new, the updateRestriction predicate is used to create an additional where clause (it will be added with AND) for the update query. This predicate can be used for concurrency checks, like checks on timestamp column values.
Public methodSaveAsync(CancellationToken)
Async variant of Save Saves the Entity class to the persistent storage. It updates or inserts the entity, which depends if the entity was originally read from the database. If the entity is new, an insert is done and the updateRestriction is ignored. If the entity is not new, the updateRestriction predicate is used to create an additional where clause (it will be added with AND) for the update query. This predicate can be used for concurrency checks, like checks on timestamp column values.
Public methodSaveAsync(IPredicate)
Async variant of Save(IPredicate) Saves the Entity class to the persistent storage. It updates or inserts the entity, which depends if the entity was originally read from the database. If the entity is new, an insert is done and the updateRestriction is ignored. If the entity is not new, the updateRestriction predicate is used to create an additional where clause (it will be added with AND) for the update query. This predicate can be used for concurrency checks, like checks on timestamp column values.
Public methodSaveAsync(Boolean, CancellationToken)
Async variant of Save(Boolean) Saves the Entity class to the persistent storage. It updates or inserts the entity, which depends if the entity was originally read from the database. If the entity is new, an insert is done and the updateRestriction is ignored. If the entity is not new, the updateRestriction predicate is used to create an additional where clause (it will be added with AND) for the update query. This predicate can be used for concurrency checks, like checks on timestamp column values.
Public methodSaveAsync(IPredicate, Boolean)
Async variant of Save(IPredicate, Boolean) Saves the Entity class to the persistent storage. It updates or inserts the entity, which depends if the entity was originally read from the database. If the entity is new, an insert is done and the updateRestriction is ignored. If the entity is not new, the updateRestriction predicate is used to create an additional where clause (it will be added with AND) for the update query. This predicate can be used for concurrency checks, like checks on timestamp column values.
Public methodSaveAsync(IPredicate, CancellationToken)
Async variant of Save(IPredicate) Saves the Entity class to the persistent storage. It updates or inserts the entity, which depends if the entity was originally read from the database. If the entity is new, an insert is done and the updateRestriction is ignored. If the entity is not new, the updateRestriction predicate is used to create an additional where clause (it will be added with AND) for the update query. This predicate can be used for concurrency checks, like checks on timestamp column values.
Public methodSaveAsync(IPredicate, Boolean, CancellationToken)
Async variant of Save(IPredicate, Boolean) Saves the Entity class to the persistent storage. It updates or inserts the entity, which depends if the entity was originally read from the database. If the entity is new, an insert is done and the updateRestriction is ignored. If the entity is not new, the updateRestriction predicate is used to create an additional where clause (it will be added with AND) for the update query. This predicate can be used for concurrency checks, like checks on timestamp column values.
Public methodSaveFields
Saves the current set of fields under the name specified in an internal hashtable. All data inside the field objects is preserved. If there is already a set of fields saved under the name specified, that set of fields is overwritten.
(Inherited from IEntityCore.)
Public methodSetEntityError
Sets the error message which is returned by IDataErrorInfo.Error
(Inherited from IEntityCore.)
Public methodSetEntityFieldError
Sets the error message for the field specified. If there's already a message stored for this field, it's overwritten unless append is set to true, which appends the message to the existing error using a semi-colon as separator. The message stored is returned by IDataErrorInfo[fieldName];
(Inherited from IEntityCore.)
Public methodSetNewFieldValue(Int32, Object)
Sets the EntityField on index fieldIndex to the new value value. Marks also the entityfields as dirty. Will refetch the complete entity's fields from the database if necessary (i.e. the entity is outofsync.).
(Inherited from IEntityCore.)
Public methodSetNewFieldValue(String, Object)
Sets the EntityField with the name fieldName to the new value value. Marks also the entityfields as dirty. Will refetch the complete entity's fields from the database if necessary (i.e. the entity is outofsync.).
(Inherited from IEntityCore.)
Public methodSetRelatedEntity
Sets the internal parameter related to the fieldname passed to the instance relatedEntity.
(Inherited from IEntityCore.)
Public methodSetRelatedEntityProperty
Sets the related entity property to the entity specified. If the property is a collection, it will add the entity specified to that collection.
(Inherited from IEntityCore.)
Public methodTestCurrentFieldValueForNull
Returns true if the current value for the field with the fieldIndex passed in represents null/not defined, false otherwise. Should not be used for testing if the original value (read from the db) is NULL
(Inherited from IEntityCore.)
Public methodTestOriginalFieldValueForNull
Returns true if the original value for the field with the fieldIndex passed in, read from the persistent storage was NULL, false otherwise. Should not be used for testing if the current value is NULL, use TestCurrentFieldValueForNull(Enum) for that.
(Inherited from IEntityCore.)
Public methodTransactionCommit
When the ITransaction in which this element participates is commited, this element can succesfully finish actions performed by this element. This method is called by ITransaction, you should not call it by yourself. When this element doesn't participate in a transaction it finishes the actions itself, calling this method is not needed.
(Inherited from ITransactionalElement.)
Public methodTransactionRollback
When the ITransaction in which this element participates is rolled back, this element has to roll back its internal variables. This method is called by ITransaction, you should not call it by yourself.
(Inherited from ITransactionalElement.)
Public methodUnsetRelatedEntity(IEntityCore, String)
Unsets the internal parameter related to the fieldname passed to the instance relatedEntity. Reverses the actions taken by SetRelatedEntity()
(Inherited from IEntityCore.)
Public methodUnsetRelatedEntity(IEntityCore, String, Boolean)
Unsets the internal parameter related to the fieldname passed to the instance relatedEntity. Reverses the actions taken by SetRelatedEntity()
(Inherited from IEntityCore.)
Public methodValidateEntity
General validation method which isn't used by the LLBLGen Pro framework, but can be used by your own code to validate an entity at any given moment.
(Inherited from IEntityCore.)
Public methodWriteXml(String)
Converts the data inside inside this entity into XML, recursively.
(Inherited from IEntityCore.)
Public methodWriteXml(String, String)
Converts the data inside inside this entity into XML, recursively.
(Inherited from IEntityCore.)
Public methodWriteXml(XmlDocument, XmlNode)
Converts the data inside inside this entity into XML, recursively.
(Inherited from IEntityCore.)
Public methodWriteXml(XmlFormatAspect, String)
Converts this entity to XML, recursively.
(Inherited from IEntityCore.)
Public methodWriteXml(String, XmlDocument, XmlNode)
Converts the data inside inside this entity into XML, recursively.
(Inherited from IEntityCore.)
Public methodWriteXml(XmlFormatAspect, String, String)
Converts this entity to XML, recursively.
(Inherited from IEntityCore.)
Public methodWriteXml(XmlFormatAspect, XmlDocument, XmlNode)
Converts this entity to XML, recursively. Uses the LLBLGenProEntityName for the rootnode name
(Inherited from IEntityCore.)
Public methodWriteXml(XmlFormatAspect, String, XmlDocument, XmlNode)
Converts this entity to XML, recursively.
(Inherited from IEntityCore.)
Top
See Also