Occurs before creating a new object of the type selected in the NewObjectViewController.NewObjectAction's control.
public event EventHandler<ObjectCreatingEventArgs> ObjectCreating
Public Event ObjectCreating As EventHandler(Of ObjectCreatingEventArgs)
The ObjectCreating event handler receives an argument of the ObjectCreatingEventArgs type. The following properties provide information specific to this event.
|Cancel||Specifies whether or not an object creation should be canceled.|
|DisposeObjectSpaceOnCancel||Specified whether or not an Object Space should be disposed on canceling a new object creation.|
|NewObject||Specifies a newly created object.|
|ObjectSpace||Specifies an Object Space used to create a new object.|
|ObjectType||Specifies a type of an object to be created.|
|ShowDetailView||Specifies whether or not a newly created object should be shown in a Detail View.|
This event can be handled to do the following:
To determine the type of the object to be created, use the handler's ObjectCreatingEventArgs.ObjectType parameter.
The WebApplication.OptimizationSettings.AllowFastProcessObjectsCreationActions option can influence the ObjectCreating event. Disable this option as described in the Faster rendering and other performance optimizations for popular Web UI scenarios in XAF KB article, if you face any difficulty when custom processing selected items is implemented in this event handler (e.g., difficulty with the default UI elements rendering or behavior).
To see an example of how to handle the ObjectCreating event, refer to the How to: Limit the Amount of Objects Created using the New Action topic.