IObjectSpace.CreateObject<ObjectType>() Method

Creates an object of the type designated by the specified generic type parameter.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v24.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

ObjectType CreateObject<ObjectType>()

VB.NET

Function CreateObject(Of ObjectType) As ObjectType

Type Parameters

Name
ObjectType

Returns

Type	Description
ObjectType	A created object of the specified type.

Remarks

The following example uses a Parametrized Action to create a new Department object and add it to the Departments collection of the current Contact object.

C#

using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Actions;
using DevExpress.Persistent.Base;
// ...
public class AddDepartmentController : ObjectViewController<DetailView, Contact> {
    public AddDepartmentController() {
        ParametrizedAction addDepartmentAction = new ParametrizedAction(this, "AddDepartment", PredefinedCategory.Edit, typeof(string));
        addDepartmentAction.Execute += AddDepartmentAction_Execute;
    }
    private void AddDepartmentAction_Execute(object sender, ParametrizedActionExecuteEventArgs e) {
        Department department = ObjectSpace.CreateObject<Department>();
        department.Title = e.ParameterCurrentValue as string;
        Contact contact = (Contact)View.CurrentObject;
        contact.Departments.Add(department);
    }
}

VB.NET

Imports DevExpress.ExpressApp
Imports DevExpress.ExpressApp.Actions
Imports DevExpress.Persistent.Base

Public Class AddDepartmentController
    Inherits ObjectViewController(Of DetailView, Contact)
    Public Sub New()
        Dim addDepartmentAction As New ParametrizedAction(
            Me, "AddDepartment", PredefinedCategory.Edit, GetType(String))
        AddHandler addDepartmentAction.Execute, AddressOf AddDepartmentAction_Execute
    End Sub
    Private Sub AddDepartmentAction_Execute(ByVal sender As Object, ByVal e As ParametrizedActionExecuteEventArgs)
        Dim department As Department = ObjectSpace.CreateObject(Of Department)()
        department.Title = TryCast(e.ParameterCurrentValue, String)
        Dim contact As Contact = CType(View.CurrentObject, Contact)
        contact.Departments.Add(department)
    End Sub
End Class

If you implement the IObjectSpace interface in the BaseObjectSpace class’ descendant, you don’t have to override the CreateObject<ObjectType> method entirely. The BaseObjectSpace.CreateObject<ObjectType> method invokes a protected virtual BaseObjectSpace.CreateObjectCore method and then sets the returned object modified by calling the BaseObjectSpace.SetModified method for it. So, you should only override the CreateObjectCore method.

The created object will be saved to the database when calling the IObjectSpace.CommitChanges method.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the CreateObject<ObjectType>() method.

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-show-persistent-objects-in-a-non-persistent-objects-view/CS/ComplexDialogSample.Module/DatabaseUpdate/Updater.cs#L27

if (ObjectSpace.FindObject<Team>(null) == null) {
    var team = ObjectSpace.CreateObject<Team>();
    team.Name = "Violet";

XAF_Non-Persistent-Objects-Nested-In-Persistent-Objects-Demo/CS/NonPersistentObjectsDemo.Module/DatabaseUpdate/Updater.cs#L33

if(sampleUser == null) {
    sampleUser = ObjectSpace.CreateObject<PermissionPolicyUser>();
    sampleUser.UserName = "User";

XAF_Non-Persistent-Objects-Reloading-Demo/CS/NonPersistentObjectsDemo.Module/BusinessObjects/DemoData.cs#L24

for(var i = 0; i < productNames.Length; i++) {
    var product = ObjectSpace.CreateObject<Product>();
    product.Name = productNames[i];

XAF_Non-Persistent-Objects-Edit-Linked-Persistent-Objects-Demo/CS/NonPersistentObjectsDemo.Module/BusinessObjects/DemoData.cs#L33

private Product CreateProduct(Category category, string model, decimal price) {
    var product = ObjectSpace.CreateObject<Product>();
    product.Model = model;

xaf-how-to-implement-a-security-system-user-based-on-an-existing-business-class/CS/EmployeeAsUserExample.Module/DatabaseUpdate/Updater.cs#L19

if (adminEmployeeRole == null) {
    adminEmployeeRole = ObjectSpace.CreateObject<EmployeeRole>();
    adminEmployeeRole.Name = SecurityStrategy.AdministratorRoleName;

VB.NET

xaf-how-to-show-persistent-objects-in-a-non-persistent-objects-view/VB/ComplexDialogSample.Module/DatabaseUpdate/Updater.vb#L29

If ObjectSpace.FindObject(Of Team)(Nothing) Is Nothing Then
    Dim team = ObjectSpace.CreateObject(Of Team)()
    team.Name = "Violet"

XAF_Non-Persistent-Objects-Nested-In-Persistent-Objects-Demo/VB/NonPersistentObjectsDemo.Module/DatabaseUpdate/Updater.vb#L35

If sampleUser Is Nothing Then
    sampleUser = ObjectSpace.CreateObject(Of PermissionPolicyUser)()
    sampleUser.UserName = "User"

XAF_Non-Persistent-Objects-Reloading-Demo/VB/NonPersistentObjectsDemo.Module/BusinessObjects/DemoData.vb#L24

For i = 0 To productNames.Length - 1
    Dim product = ObjectSpace.CreateObject(Of Product)()
    product.Name = productNames(i)

XAF_Non-Persistent-Objects-Edit-Linked-Persistent-Objects-Demo/VB/NonPersistentObjectsDemo.Module/BusinessObjects/DemoData.vb#L33

Private Function CreateProduct(ByVal category As Category, ByVal model As String, ByVal price As Decimal) As Product
    Dim product = ObjectSpace.CreateObject(Of Product)()
    product.Model = model

xaf-how-to-implement-a-security-system-user-based-on-an-existing-business-class/VB/EmployeeAsUserExample.Module/DatabaseUpdate/Updater.vb#L22

If adminEmployeeRole Is Nothing Then
    adminEmployeeRole = ObjectSpace.CreateObject(Of EmployeeRole)()
    adminEmployeeRole.Name = SecurityStrategy.AdministratorRoleName