Property :: insertObject - Insert object by object identity

The function provides a fast way for building an object collection. The function only adds the instances to the collection index without checking the instance data type. The application is responsible to pass object identities for proper instances. Otherwise, reading instances from the collection later might result in a type conflict. In order to avoid type conflicts, the collection might be defined as VOID collection .

Maximum one access key (sort order) can be defined for the collection. When an access key is selected for the collection, a key value must be passed. For unordered collections, new instances are appended at the end of the collection.

The function can be used for adding instances to collections, only, which are not instance owner and which do not have inverse relationship or base collections. There function is typically used for creating transient or temporary collections.