Click or drag to resize

EntityBase Methods

The EntityBase type exposes the following members.

Methods
  NameDescription
Protected methodAddInternalsToContext
Adds the internals to context.
(Inherited from EntityCoreTFields.)
Protected methodAddToTransactionIfNecessary
Adds the specified entity to the transaction this entity is in, if necessary.
Protected methodCheckForRefetch
Will check if the entity should refetch itself. Will use the factory pattern trick. Refetching occurs when the EntityFields are marked OutOfSync and thus not dirty.
(Overrides EntityCoreTFieldsCheckForRefetch.)
Protected methodCheckIfCurrentFieldValueIsNull Obsolete.
Checks if the current value of the field on the index specified is null / not defined.
(Inherited from EntityCoreTFields.)
Protected 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 EntityCoreTFields.)
Protected methodCheckIfLazyLoadingShouldOccur
Checks if lazy loading should occur for the relation passed in and the FK fields in this entity for the relation Routine is used by GetSingle... lazy loaders in selfservicing entities.
Protected methodCreateAuditor
Creates the auditor object for this entity. Routine is called when the entity is constructed. Implement in an entity class to set a particular entity auditor object at construction time. Use this method if you don't want to use LLBLGen Pro's build in dependency injection mechanism.
(Inherited from EntityCoreTFields.)
Protected methodCreateAuthorizer
Creates the authorizer object for this entity. Routine is called when the entity is constructed. Implement in an entity class to set a particular entity authorizer object at construction time. Use this method if you don't want to use LLBLGen Pro's build in dependency injection mechanism.
(Inherited from EntityCoreTFields.)
Protected methodCreateConcurrencyPredicateFactory
Creates the concurrency predicate factory for this entity. Routine is called from the entity constructor. Implement in an entity class to set a particular ConcurrentyPredicateFactory object at construction time. Use this method if you don't want to use LLBLGen Pro's build in dependency injection mechanism.
(Inherited from EntityCoreTFields.)
Protected methodCreateDAOInstance
Creates the DAO instance for this type
Protected methodCreateEntityFactoryCore
Creates a new entity factory instance related to this entity.
(Overrides EntityCoreTFieldsCreateEntityFactoryCore.)
Protected methodCreateFields
Creates entity fields object for this entity. Used in constructor to setup this entity in a polymorphic scenario.
(Overrides EntityCoreTFieldsCreateFields.)
Protected methodCreateTransaction
Creates a new transaction object
Protected methodCreateTypeDefaultValueProvider
Creates the ITypeDefaultValue instance used to provide default values for value types which aren't of type nullable(of T)
(Inherited from EntityCoreTFields.)
Protected methodCreateValidator
Creates the validator object for this entity. Routine is called when the entity is constructed. Implement in an entity class to set a particular entity validator object at construction time. Use this method if you don't want to use LLBLGen Pro's build in dependency injection mechanism.
(Inherited from EntityCoreTFields.)
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.
Protected methodDeserializeEntityCoreData
Private CTor for deserialization
(Inherited from EntityCoreTFields.)
Protected methodDeserializeMemberData
Deserializes the member data of this instance.
Protected methodDesetupSync
Destructs the synchronization setup between the related entity and this entity, related over the member specified.
(Inherited from EntityCoreTFields.)
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 EntityCoreTFields.)
Protected methodEntity2Xml
Produces the actual XML for this entity, recursively. Because it recurses through referenced entities, it keeps track of which objects are processed so cyclic references are not resulting in cyclic recursion and thus a crash.
(Inherited from EntityCoreTFields.)
Public methodEquals
Compares passed in object with the given object. This is a compare of PK fields. These have to be the same in VALUES. When the values are not the same, or the type is not the same as the current type, false is returned, true otherwise. When this doesn't have any PK fields, all fields are compared. null values are considered as the same value.
(Inherited from EntityCoreTFields.)
Public methodFetchExcludedFields
Loads the data for the excluded fields specified in the list of excluded fields into this entity.
Protected methodFinalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
Protected methodFixupDeserialization(IFieldInfoProvider)
Fixes deserialization empty references, because fieldinfo isn't serialized into the data.
(Inherited from EntityCoreTFields.)
Protected methodFixupDeserialization(IFieldInfoProvider, IPersistenceInfoProvider)
Fixes deserialization empty references, because fieldinfo isn't serialized into the data.
(Inherited from EntityCoreTFields.)
Protected methodFlagAllFieldsAsChanged
A method to call OnPropertyChanged for all fields to signal to bound controls that all fields have been changed.
(Inherited from EntityCoreTFields.)
Protected methodGetAdditionalRelatedData
Gets the additional related data, next to the data returned by GetRelatedData. This method appends the additional related data to the passed in toAppendTo dictionary. Key is the property name, value is the entity object or entity collection represented by the property.
(Inherited from EntityCoreTFields.)
Protected methodGetAllRelations
Gets a list of all the EntityRelation objects the type of this instance has.
(Inherited from EntityCoreTFields.)
Protected methodGetAlreadyFetchedValueForNavigator
Returns the value for the flag _alreadyFetched*NavigatorName*. Used for lazy loading
Protected methodGetAlwaysFetchValueForNavigator
Returns the value for the flag _alwaysFetch*NavigatorName*. Used for lazy loading
Protected methodGetConcurrencyPredicate
Creates the requested predicate of the type specified. If no IConcurrencyPredicateFactory instance is stored in this entity instance, null is returned.
(Inherited from EntityCoreTFields.)
Public methodGetCurrentFieldValue
Gets the current value of the EntityField2 with the index fieldIndex.
(Inherited from EntityCoreTFields.)
Protected methodGetDependentRelatedEntitiesT
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.
(Inherited from EntityCoreTFields.)
Protected methodGetDependentRelatedEntityCoreInstances
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.
(Overrides EntityCoreTFieldsGetDependentRelatedEntityCoreInstances.)
Protected methodGetDependingRelatedEntitiesT
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.
(Inherited from EntityCoreTFields.)
Protected methodGetDependingRelatedEntityCoreInstances
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.
(Overrides EntityCoreTFieldsGetDependingRelatedEntityCoreInstances.)
Protected methodGetEntityDescription
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 EntityCoreTFields.)
Protected methodGetEntityFactoryFromCache
Gets the factory instance for the entity type specified from the cache.
Protected methodGetEntityStaticMetaData
Gets the entity static meta data instance from the generated type.
(Inherited from EntityCoreTFields.)
Protected methodGetEntitySyncInformation
Will retrieve all stored entity synchronization information for the passed in entity. If no information is stored, an empty hashtable is returned. All sync info is stored by fieldname
(Inherited from EntityCoreTFields.)
Protected methodGetEntityTypeValue
Gets the EntityType value as int for this entity.
(Inherited from EntityCoreTFields.)
Protected methodGetFromActiveContext
Gets the original entity class instance containing the same data (entity instance) as present in toGet from active context. If no active context is set, toGet is returned.
Public methodGetHashCode
Overrides the GetHashCode method. It will calculate a hashcode for this entity using the eXclusive OR of the hashcodes of the primary key fields in this entity. That hashcode is returned. If no primary key fields are present, the hashcode of the base class is returned, which will not be unique.
(Inherited from EntityCoreTFields.)
Protected methodGetInheritanceInfoProvider
Gets the inheritance info provider instance of the project this entity instance is located in.
(Inherited from EntityCoreTFields.)
Protected methodGetMemberEntityCollectionCoreInstances
Gets a list of all entity collections stored as member variables in this entity. The contents of the list is used by the DataAccessAdapter to perform recursive saves. Only 1:n related collections are returned.
(Overrides EntityCoreTFieldsGetMemberEntityCollectionCoreInstances.)
Protected methodGetObjectData
ISerializable member. Does custom serialization so event handlers do not get serialized.
(Overrides EntityCoreTFieldsGetObjectData(SerializationInfo, StreamingContext).)
Protected 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 EntityCoreTFields.)
Protected methodGetRelationsForFieldOfType
Gets the relation objects which represent the relation the fieldName specified is mapped on.
(Inherited from EntityCoreTFields.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Protected methodGetValue
Gets the value of the field with the index specified.
(Inherited from EntityCoreTFields.)
Protected methodInsertEntity
Performs the insert action of a new Entity to the persistent storage.
Protected methodInsertEntityAsync
Performs the insert action of a new Entity to the persistent storage.
Protected methodMarkFieldsAsDirty
Marks the fields as dirty.
(Inherited from EntityCoreTFields.)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Protected methodOnAuditDeleteOfEntity
Audits the successful delete of an entity from the database
(Inherited from EntityCoreTFields.)
Protected methodOnAuditDereferenceOfRelatedEntity
Audits the successful dereference of related entity from the entity passed in.
(Inherited from EntityCoreTFields.)
Protected methodOnAuditDirectDeleteOfEntities
Audits the successful direct delete of entities in the database
(Inherited from EntityCoreTFields.)
Protected methodOnAuditDirectUpdateOfEntities
Audits the succesful direct update of entities in the database.
(Inherited from EntityCoreTFields.)
Protected methodOnAuditEntityFieldGet
Audits when an entity field's value is succesfully obtained from the passed in entity
(Inherited from EntityCoreTFields.)
Protected methodOnAuditEntityFieldSet
Audits when an entity field is set succesfully to a new value.
(Inherited from EntityCoreTFields.)
Protected methodOnAuditInsertOfNewEntity
Audits the successful insert of a new entity into the database.
(Inherited from EntityCoreTFields.)
Protected methodOnAuditLoadOfEntity
Audits the successful load of an entity from the database
(Inherited from EntityCoreTFields.)
Protected methodOnAuditReferenceOfRelatedEntity
Audits the successful reference of related entity from the entity passed in.
(Inherited from EntityCoreTFields.)
Protected methodOnAuditUpdateOfExistingEntity
Audits the successful update of an existing entity in the database
(Inherited from EntityCoreTFields.)
Protected methodOnBeforeEntitySave
This method is called from the DataAccessAdapter method OnBeforeEntitySave(), unless that method is overriden. You can override this OnSave method instead, which allows you to make last minute changes, though keep the logic to do that in the entity.
(Inherited from EntityCoreTFields.)
Protected methodOnBeginEdit
Called after BeginEdit is succesfully called.
(Inherited from EntityCoreTFields.)
Protected methodOnCanBatchDeleteEntitiesDirectly
Method which will check if the caller is allowed to delete entities directly in the database.
(Inherited from EntityCoreTFields.)
Protected methodOnCanBatchUpdateEntitiesDirectly
Method which will check if the caller is allowed to update entities directly in the database.
(Inherited from EntityCoreTFields.)
Protected methodOnCancelEdit
Called after CancelEdit is succesfully called.
(Inherited from EntityCoreTFields.)
Protected methodOnCanDeleteEntity
Method which will check if the caller is allowed to delete this existing entity object
(Inherited from EntityCoreTFields.)
Protected methodOnCanGetFieldValue
Method which will check if the caller is allowed to get the field value with the index specified.
(Inherited from EntityCoreTFields.)
Protected methodOnCanLoadEntity
Method which will check if the caller is allowed to fill this entity object with entity data from the database or not.
(Inherited from EntityCoreTFields.)
Protected methodOnCanSaveExistingEntity
Method which will check if the caller is allowed to save this existing entity object
(Inherited from EntityCoreTFields.)
Protected methodOnCanSaveNewEntity
Method which will check if the caller is allowed to save this new entity object
(Inherited from EntityCoreTFields.)
Protected methodOnCanSetFieldValue
Method which will check if the caller is allowed to set the field value with the index specified.
(Inherited from EntityCoreTFields.)
Protected methodOnDelete
Called right before the entity's Delete logic is started.
Protected methodOnDeleteComplete
Called after the entity's delete routine is finished.
Protected methodOnDeserialized
Called at the end of the deserialization constructor. Method is used when this object is deserialized. Override this method to tap into the deserialization sequence. (binary/soap formatter specific).
(Inherited from EntityCoreTFields.)
Protected methodOnEndEdit
Called after EndEdit is succesfully called.
(Inherited from EntityCoreTFields.)
Protected methodOnEntityAfterSave
Event handler which is called by a related entity after that entity is persisted.
(Inherited from EntityCoreTFields.)
Protected methodOnEntityContentsChanged
Called when the entity's contents has been changed.
(Inherited from EntityCoreTFields.)
Protected methodOnFetch
Called right before the entity's Fetch logic is started.
Protected methodOnFetchComplete
Called after the entity's Fetch routine is finished.
Protected methodOnFieldsCreated
Called by CreateFields, after the fields object has been created, which are passed in.
Protected methodOnFieldValueChanged
Method which is called right after a field's value has been changed. There are a couple of methods called in the process of setting a field's value. This particular method is solely there to act on a field's value set action. It doesn't raise an event, though it receives the old and new value of the field. Not called if a fieldvalue set action failed. This method is called before changed events are raised.
(Inherited from EntityCoreTFields.)
Protected methodOnGetFetchNewAuthorizationFailureResultHint
Returns the FetchNewAuthorizationFailureResultHint as returned by the authorizer. Only called when the CanGetLoad failed (authorization failed, so load was denied)
(Inherited from EntityCoreTFields.)
Protected methodOnGetObjectData
Called at the end of GetObjectData. Method is used when this object is serialized. Override this method to tap into the serialization sequence. (binary/soap formatter specific).
(Inherited from EntityCoreTFields.)
Protected methodOnGetValue
Called right at the beginning of GetValue(), which is called from an entity field property getter
(Inherited from EntityCoreTFields.)
Protected methodOnGetValueComplete
Called right at the end of GetValue(), which is called from an entity field property getter
(Inherited from EntityCoreTFields.)
Protected methodOnInitClassMembersComplete
Called when InitClassMembers is complete.
(Inherited from EntityCoreTFields.)
Protected methodOnInitialized
Called at the end of the initialization method. Raises Initialized event.
(Inherited from EntityCoreTFields.)
Protected methodOnInitializing
Called at the start of the initialization method. Raises Initializing event.
(Inherited from EntityCoreTFields.)
Protected methodOnPropertyChanged
Called when a property changed value. Call this method to signal databound controls a property has changed.
(Inherited from EntityCoreTFields.)
Protected methodOnRelatedEntitySet
Method which is called at the end of the SetRelatedEntity() method. Usable to act on the fact that a related entity has been set.
(Inherited from EntityCoreTFields.)
Protected methodOnRelatedEntityUnset
Method which is called at the end of the UnsetRelatedEntity() method. Usable to act on the fact that an entity has been dereferenced as a related entity by the containing entity.
(Inherited from EntityCoreTFields.)
Protected methodOnRequiresTransactionForAuditEntities
Method which returns true if this auditor expects to have audit entities to persist and therefore needs a transaction. This method is called in the situation when there's no transaction going on though one should be started right before the single-statement action in the case if the auditor has entities to save afterwards. It's recommended to return true if the auditor might have audit entities to persist after an entity save/delete/direct update/direct delete of entities. Default: false
(Inherited from EntityCoreTFields.)
Protected methodOnSave
Called right before the entity's save logic is started. This is right after all entities this entity depends on are saved succesfully.
Protected methodOnSaveComplete
Called after the entity's save routine is finished.
Protected methodOnSetRelatedEntityProperty
Method which is called in the default clause of the SetRelatedEntityProperty method during the merge process of prefetch path fetches.
(Inherited from EntityCoreTFields.)
Protected methodOnSetValue
Called right at the beginning of SetValue(), which is called from an entity field property setter
(Inherited from EntityCoreTFields.)
Protected methodOnSetValueComplete
Called right at the end of SetValue(), which is called from an entity field property setter
(Inherited from EntityCoreTFields.)
Protected methodOnTransactionCommit
Called after the TransactionCommit method has been finished.
(Inherited from EntityCoreTFields.)
Protected methodOnTransactionRollback
Called after the TransactionRollback method has been finished.
(Inherited from EntityCoreTFields.)
Protected methodOnValidateEntityAfterLoad
Method to validate the containing entity after it is loaded. This method is called after the entity has been fully loaded.
(Inherited from EntityCoreTFields.)
Protected methodOnValidateEntityAfterSave
Method to validate the containing entity right after the entity's save action has been completed and the entity has been refetched (if applicable). Note for adapter users: if the entity wasn't set to be refetched, take into account that reading properties from the containing entity will result in an OutOfSync exception.
(Inherited from EntityCoreTFields.)
Protected methodOnValidateEntityBeforeDelete
Method to validate the containig entity right beforethe entity's delete action will take place.
(Inherited from EntityCoreTFields.)
Protected methodOnValidateEntityBeforeSave
Method to validate the containing entity right before the save sequence for the entity will start. LLBLGen Pro will call this method right after the containing entity is selected from the save queue to be saved.
(Inherited from EntityCoreTFields.)
Protected methodOnValidateFieldValue
Method which will validate, using custom code supplied this class, the field with index fieldIndex if it should accept the specified value. This method is only called when standard checks already succeeded, so value isn't null, and value does match the destination column definition of the EntityField related to fieldIndex.
(Inherited from EntityCoreTFields.)
Protected methodPerformCustomXmlDeserialization
Performs custom XML deserialization for properties which have the CustomXmlSerializationAttribute. The xmlreader should be used to read the xml from. The reader is positioned on the StartElement of the property which has the name of the property. Check if the element is empty and if not, read till the reader is positioned on the EndElement of the property (which also has the same name). Your override has to set the property's value, using the descriptor's SetValue method.
(Inherited from EntityCoreTFields.)
Protected methodPerformCustomXmlSerialization
Performs custom XML serialization for properties which have the CustomXmlSerializationAttribute. Override this method if for some property the data has to be serialized into the output. The xmlwriter should be used to write xml to. You shouldn't emit a startelement with the propertyname, that's already done. Also you shouldn't emit an endelement with the propertyname, that will be done for you. Simply emit XML with the data. Be sure the xml data is valid. You can use the XmlHelper class if necessary.
(Inherited from EntityCoreTFields.)
Protected methodPerformDependencyInjection
Performs the dependency injection of related objects. This method will call the Create* methods to create validator, concurrency predicate factory and will then kick in the DependencyInjection functionality build into LLBLGen Pro. This method is called at the end of an entity's InitClassMembers method in the generated code.
(Inherited from EntityCoreTFields.)
Protected methodPerformDesyncSetupFKFieldChange
Performs the desync setup when an FK field has been changed. The entity referenced based on the FK field will be dereferenced and sync info will be removed.
(Inherited from EntityCoreTFields.)
Protected methodPerformMultiEntityLazyLoadingTCollection
Performs a 1:n lazy loading fetch for the navigator specified.
Protected methodPerformPostReadXmlFixups
Routine which is used to perform tasks after a ReadXml() action on this entity instance was performed
(Overrides EntityCoreTFieldsPerformPostReadXmlFixups.)
Protected methodPerformRelatedEntityRemoval
Performs the related entity removal.
(Inherited from EntityCoreTFields.)
Protected methodPerformSingleEntityLazyLoadingTEntity(String, Boolean, Boolean, FuncTEntity)
Performs a single-entity lazy loading action. Inheritance variant
Protected methodPerformSingleEntityLazyLoadingTEntity(String, Boolean, Boolean, FuncTEntity, Boolean)
Performs a single entity lazy loading action. Non-inheritance variant
Protected methodPostFieldValueSetAction
Method to perform post-fieldvalue set actions, like flagging this object as changed.
(Inherited from EntityCoreTFields.)
Protected methodPostProcessValueToGet
Post-processes the value to return from GetValue. Override this method to be able to post-process any value to return from an entity field's property.
(Inherited from EntityCoreTFields.)
Protected methodPreProcessValueToSet
Method which is meant to be overriden to pre-process a value right before it is set as a field's new value. In general you don't need to override this method. By default it's a no-op.
(Inherited from EntityCoreTFields.)
Public methodReadXml(String)
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 IEntityCore.WriteXml() and the Xml has to be compatible with the structure of this entity collection.
(Inherited from EntityCoreTFields.)
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 IEntityCore.WriteXml() and the Xml has to be compatible with the structure of this entity collection.
(Inherited from EntityCoreTFields.)
Public methodReadXml(XmlReader)
Constructs an object graph with this object as the root from the xml contained by the passed in XmlReader object.
(Inherited from EntityCoreTFields.)
Protected methodReadXml(XmlNode, XmlFormatAspect)
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 IEntityCore.WriteXml() and the Xml has to be compatible with the structure of this entity collection.
(Inherited from EntityCoreTFields.)
Public methodReadXml(XmlReader, XmlFormatAspect)
Constructs an object graph with this object as the root from the xml contained by the passed in XmlReader object.
(Inherited from EntityCoreTFields.)
Protected methodReadXmlExplicitImpl
Calls into ReadXml(reader), which will use the document route.
(Overrides EntityCoreTFieldsReadXmlExplicitImpl(XmlReader).)
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.
Protected methodRemoveFromParentCollection
Removes this instance from the parent collection (if present), to which it was added through databinding
(Overrides EntityCoreTFieldsRemoveFromParentCollection.)
Protected methodRemoveFromTransactionIfNecessary
Removes the specified element from the transaction this entity is in if necessary.
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 EntityCoreTFields.)
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 EntityCoreTFields.)
Protected methodSetAlreadyFetchedValueForNavigator
Sets the _alreadyFetched*Navigatorname* flag for the navigator specified to the value specified.
(Overrides EntityCoreTFieldsSetAlreadyFetchedValueForNavigator(String, Boolean, Boolean).)
Protected methodSetAlwaysFetchValueForNavigator
Sets the _alwaysFetch*Navigatorname* flag for the navigator specified to the value specified.
Protected methodSetDiscriminatorFlagIfRequired
Sets the discriminator flag if required.
(Inherited from EntityCoreTFields.)
Public methodSetEntityError
Sets the error message which is returned by IDataErrorInfo.Error
(Inherited from EntityCoreTFields.)
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 EntityCoreTFields.)
Protected methodSetEntitySyncInformation
Will set the passed in information as Entity sync information. If there is no sync information stored yet for the related entity then a new entry is created, otherwise it's info is added to the sync information of this entity, if it isn't already present. If there is already sync information for this field stored for another related entity, that information is removed.
(Inherited from EntityCoreTFields.)
Public methodSetNewFieldValue(Int32, Object)
Sets the EntityField2 on index fieldIndex to the new value value. Marks also the entityfields2 as dirty.
(Inherited from EntityCoreTFields.)
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 EntityCoreTFields.)
Protected methodSetNewFieldValue(Int32, Object, Boolean) Obsolete.
Sets the Entity Field on index fieldIndex to the new value value. Marks also the entityfields2 as dirty.
(Inherited from EntityCoreTFields.)
Protected methodSetRelatedEntity
Sets the internal parameter related to the fieldname passed to the instance relatedEntity.
(Overrides EntityCoreTFieldsSetRelatedEntity(IEntityCore, String).)
Protected 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.
(Overrides EntityCoreTFieldsSetRelatedEntityProperty(String, IEntityCore).)
Protected methodSetSingleRelatedEntityNavigator
Sets the single related entity navigator to the value (toSet) specified. This isn't done directly, but indirecly by the opposite entity
Protected methodSetupSyncT
Sets up the synchronization between the related entity and this entity, related over the member specified.
(Inherited from EntityCoreTFields.)
Protected methodSetValue(Int32, Object)
Sets the value of the field with the index specified to the value specified.
(Inherited from EntityCoreTFields.)
Protected methodSetValue(Int32, Object, Boolean)
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 EntityCoreTFields.)
Protected methodSetValue(Int32, Object, Boolean, Boolean)
Sets the value of the field with the index specified to the value specified.
(Inherited from EntityCoreTFields.)
Protected methodSyncFKFields
Synchronizes the PK values of the dataSupplier with the related FK values of this entity.
(Inherited from EntityCoreTFields.)
Public methodTestCurrentFieldValueForNull Obsolete.
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 EntityCoreTFields.)
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 EntityCoreTFields.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Protected methodUnsetEntitySyncInformation
Will unset (remove) the passed in information as Entity sync information. If there is no sync information stored for the related entity after this info has been removed, the complete hashentry is removed.
(Inherited from EntityCoreTFields.)
Protected methodUnsetRelatedEntity
Unsets the internal parameter related to the fieldname passed to the instance relatedEntity. Reverses the actions taken by SetRelatedEntity()
(Overrides EntityCoreTFieldsUnsetRelatedEntity(IEntityCore, String, Boolean).)
Protected methodUpdateEntity Obsolete.
Performs the update action of an existing Entity to the persistent storage.
Protected methodUpdateEntity(IPredicate)
Performs the update action of an existing Entity to the persistent storage.
Protected methodUpdateEntityAsync(CancellationToken)
Performs the update action of an existing Entity to the persistent storage.
Protected methodUpdateEntityAsync(IPredicate, CancellationToken)
Performs the update action of an existing Entity to the persistent storage.
Protected methodValidate Obsolete.
Method to keep code compilable however which is now marked as obsolete, as people should call ValidateEntity.
(Inherited from EntityCoreTFields.)
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 EntityCoreTFields.)
Public methodWriteXml(XmlWriter)
Constructs the XML output from the object graph which has this object as the root.
(Overrides EntityCoreTFieldsWriteXml(XmlWriter).)
Public methodWriteXml(String)
Converts this entity to XML, recursively. Uses the LLBLGenProEntityName for the rootnode name
(Inherited from EntityCoreTFields.)
Public methodWriteXml(String, String)
Converts this entity to XML, recursively.
(Inherited from EntityCoreTFields.)
Public methodWriteXml(XmlDocument, XmlNode)
Converts this entity to XML, recursively. Uses the LLBLGenProEntityName for the rootnode name
(Inherited from EntityCoreTFields.)
Public methodWriteXml(XmlWriter, XmlFormatAspect)
Converts this entity to XML
(Inherited from EntityCoreTFields.)
Public methodWriteXml(XmlFormatAspect, String)
Converts this entity to XML, recursively. Uses the LLBLGenProEntityName for the rootnode name
(Inherited from EntityCoreTFields.)
Public methodWriteXml(String, XmlDocument, XmlNode)
Converts this entity to XML, recursively.
(Inherited from EntityCoreTFields.)
Public methodWriteXml(XmlWriter, XmlFormatAspect, String)
Converts this entity to XML
(Inherited from EntityCoreTFields.)
Public methodWriteXml(XmlFormatAspect, String, String)
Converts this entity to XML, recursively.
(Overrides EntityCoreTFieldsWriteXml(XmlFormatAspect, String, String).)
Public methodWriteXml(XmlFormatAspect, XmlDocument, XmlNode)
Converts this entity to XML, recursively. Uses the LLBLGenProEntityName for the rootnode name
(Inherited from EntityCoreTFields.)
Public methodWriteXml(XmlWriter, XmlFormatAspect, String, DictionaryGuid, IEntityCore)
Converts this entity to XML
(Inherited from EntityCoreTFields.)
Public methodWriteXml(XmlFormatAspect, String, XmlDocument, XmlNode)
Converts this entity to XML, recursively.
(Overrides EntityCoreTFieldsWriteXml(XmlFormatAspect, String, XmlDocument, XmlNode).)
Protected methodXml2Entity(XmlNode, DictionaryGuid, IEntityCore, ListNodeEntityReference)
Performs the actual conversion from Xml to entity data.
(Overrides EntityCoreTFieldsXml2Entity(XmlNode, DictionaryGuid, IEntityCore, ListNodeEntityReference).)
Protected methodXml2Entity(XmlReader, DictionaryGuid, IEntityCore, ListNodeEntityReference)
Performs the actual conversion from Xml to entity data.
(Inherited from EntityCoreTFields.)
Top
Explicit Interface Implementations
  NameDescription
Explicit interface implementationPrivate methodIEditableObjectBeginEdit
Begins an edit on an object.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEditableObjectCancelEdit (Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEditableObjectEndEdit (Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodISerializableGetObjectData
Populates a SerializationInfo with the data needed to serialize the target object.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIXmlSerializableGetSchema
Produce the schema, always return null, as the XmlSerializer object otherwise can't handle our code.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIDeserializationCallbackOnDeserialization
Runs when the entire object graph has been deserialized.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIXmlSerializableReadXml
Constructs an object graph with this object as the root from the xml contained by the passed in XmlReader object.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityGetDependentRelatedEntities
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.
Explicit interface implementationPrivate methodIEntityGetDependingRelatedEntities
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.
Explicit interface implementationPrivate methodIEntityGetEntityFactory
Returns a new ready to use factory for the type of this instance.
Explicit interface implementationPrivate methodIEntityGetMemberEntityCollections
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.
Explicit interface implementationPrivate methodIEntityCoreAcceptChanges
Accepts the changes made to the fields. Used in databinding/service scenarios. Calls AcceptChanges on the fields in this entity
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreCheckIfEntityHasPendingFkSyncsTEntity
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 EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreCheckIfIsSubTypeOf
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 EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreDiscardSavedFields
Removes all saved field sets from the internal hashtable, clearing up space. This method is also called when an entity is saved.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreFlagAsSaved
Flags me as saved.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreFlagMeAsChanged
Routine which will flag all subscribers of the EntityContentsChanged event that this entity's contents is changed.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreGetAllRelations
Gets a list of all the EntityRelation objects the type of this instance has.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreGetConcurrencyPredicate
Creates the requested predicate of the type specified. If no IConcurrencyPredicateFactory instance is stored in this entity instance, null is returned.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreGetDependentRelatedEntities
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.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreGetDependingRelatedEntities
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.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreGetEntityDescription(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 EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreGetEntityDescription(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 EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreGetEntityFactory
Returns a new ready to use factory for the type of this instance.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreGetFieldByName
Helper method which performs a lookup in the fields based on the name specified.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreGetInheritanceInfo
Gets the inheritance info for this entity, if applicable (it's then overriden) or null if not.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreGetInheritanceInfoProvider
Gets the inheritance info provider instance of the project this entity instance is located in.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreGetMemberEntityCollections
Gets a list of all entity collections stored as member variables in this entity. The contents of the list is used by the DataAccessAdapter to perform recursive saves. Only 1:n related collections are returned.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreGetRelatedData
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 EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreGetRelationsForFieldOfType
Gets the relation objects which represent the relation the fieldName specified is mapped on.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreRejectChanges
Rejects the changes made to the fields. Used in databinding/service scenarios. Calls RejectChanges on the fields in this entity
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreRollbackFields
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 EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreSaveFields
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 EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreSetRelatedEntity
Sets the internal parameter related to the fieldname passed to the instance relatedEntity.
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreSetRelatedEntityProperty
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 EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreUnsetRelatedEntity(IEntityCore, String)
Unsets the internal parameter related to the fieldname passed to the instance relatedEntity. Reverses the actions taken by SetRelatedEntity()
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodIEntityCoreUnsetRelatedEntity(IEntityCore, String, Boolean)
Unsets the internal parameter related to the fieldname passed to the instance relatedEntity. Reverses the actions taken by SetRelatedEntity()
(Inherited from EntityCoreTFields.)
Explicit interface implementationPrivate methodITransactionalElementTransactionCommit
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 EntityCoreTFields.)
Explicit interface implementationPrivate methodITransactionalElementTransactionRollback
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 EntityCoreTFields.)
Top
See Also