Property :: canCreate - Can instance(s) be created for collection
The function checks, whether new instances can be created for the collection or not. The function returns true, when creating a new instance and adding it to the collection is possible. Otherwise, the function returns false.
Returning true always implies canUpdateCollection(), but not necessarily the reverse. There are several reasons rejecting creating an instance:
- The property handle is opened for read, only
- The collection is not an owning collection and not extent based
- Instance cannot be created into base extent (super set.canCreate())
- Inverse reference exists but cannot be updated (inverse.canUpdateCollection())
- Maximum number of instances in the collection exceeded
- The current application does not have rights for inserting the instance (disabled by context)
- The property handle is invalid.
- Updating is denied by context handler (client or server) TypeContext::canCreate()
Return value: Success ( bool )
The value is true when the function was executed successfully. Otherwise the value is set to false.