company logo

Property :: collectionUpdateCount - Number of changes for a collection

The property returns an internal modification count for a persistent collections. This allows checking whether the collection has been updated (insert(), erase() or rename()) by another user or application after last reading it, since each modification will increase the modification count stored in the database.

Since the update count is rotating (starting again with 1 after reaching 65,535) this is a "nearly" save indication, only. Thus, it is suggested to use server event handler in order to react on collection modifications.

The function throws an exception, when the property handle is not accessible, i.e. when the parent property handle is not selected or the property handle is invalid.

Return value:  Number of items ( int32  )

The value contains the number of items to be processed or stored in a collection.

Implementation details

int32 Property  :: collectionUpdateCount (  )