NewObjectViewController.ObjectCreating Event

Occurs before creating a new object of the type selected in the NewObjectViewController.NewObjectAction‘s control.

Namespace: DevExpress.ExpressApp.SystemModule

Assembly: DevExpress.ExpressApp.v24.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

public event EventHandler<ObjectCreatingEventArgs> ObjectCreating

VB.NET

Public Event ObjectCreating As EventHandler(Of ObjectCreatingEventArgs)

Event Data

The ObjectCreating event's data class is ObjectCreatingEventArgs. The following properties provide information specific to this event:

Property	Description
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.

Remarks

This event can be handled to do the following:

• Cancel creating a new object. For this purpose, set the event hander’s ObjectCreatingEventArgs.Cancel parameter to true. By default, it is set to false.
• Cancel invoking the Detail View for initialization of the newly created object. For this purpose, set the event handler’s ObjectCreatingEventArgs.ShowDetailView parameter to false. By default, it is set to true.
• Create the new object yourself. For this purpose, use the IObjectSpace object passed as the handler’s ObjectCreatingEventArgs.ObjectSpace parameter. To pass the newly created object to the system, set it for the handler’s ObjectCreatingEventArgs.NewObject parameter.

To determine the type of the object to be created, use the handler’s ObjectCreatingEventArgs.ObjectType parameter.

Note

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.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ObjectCreating event.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

xaf-how-to-implement-a-custom-security-operation-that-can-be-permitted-at-the-type-level/CS/CustomSecurityOperation.Module/Controllers/RemoveBaseTypePermissionNewActionItemController.cs#L16

};
newObjectViewController.ObjectCreating += (s, e) => {
    if(e.ObjectType == typeof(PermissionPolicyTypePermissionObject)) {

VB.NET

xaf-how-to-implement-a-custom-security-operation-that-can-be-permitted-at-the-type-level/VB/CustomSecurityOperation.Module/Controllers/RemoveBaseTypePermissionNewActionItemController.vb#L17

AddHandler _newObjectViewController.ObjectCreating, Sub(s, e)
                                                        If e.ObjectType = GetType(PermissionPolicyTypePermissionObject) Then