[This is preliminary documentation and is subject to change.]
Inserts a new or selected object to a contained or associated
collection
Declaration Syntax
C# |
public static ExecutionResult ExecuteInsert( Execution execution )
Parameters
- execution (Execution)
- The Execution object created for the Insert operation. This must specify both a target object and a target collection.
Return Value
For contained collections, NoActionResult if no object was created, or else
an ExecutionResult with ResultAction of Commit and with the
Result containing the new object. For associated collections, the ExecutionResult returned from SelectToAdd
Remarks
The action of Insert depends on whether the collection is
contained or associated. If contained, this performs similarly to ExecuteNew, and if associated, it performs
similarly to ExecuteAdd, calling the SelectToAdd method. The difference is that the
object(s) is/are inserted in the collection at the index currently occupied
by the target object. The target and subsequent objects are moved
down.