AcquireReservation(IDataObject, ISchema, String):IDataObjectNameReservation

Creates a reservation for a name.

This method generates, underneath the indicated data object, a reservation for a name of a data object. This means that, in this level, no further data object can be created or existing data object renamed which bears this name.

Parameter

parent

Type: Onion.Client.IDataObject

This parameter indicates the data object underneath which the reservation as a child object is to be created.

schema

Type: Onion.Client.ISchema

This parameter is the schema the reservation is to follow.

Reservations must also follow a schema so that they can be created underneath another data object.

The schema for the next logic layer up - the ChangeSets - is important. ChangeSets are based on locks. If a data object is created in a ChangeSet, then the data object follows a schema. If it is published, the reservation becomes a complete data object. Modifying the schema is no longer possible at the time of publication and must therefore be correctly set at the beginning.

objectName

Type: System.String

This parameter is the name of the reservation or of the data object.

This name is reserved and can no longer be used in this level by other data objects.