BaseObject Class

Represents a base persistent class from which business classes can be inherited.

Namespace: DevExpress.Persistent.BaseImpl

Assembly: DevExpress.Persistent.BaseImpl.v21.1.dll

NuGet Package: DevExpress.Persistent.BaseImpl

Declaration

C#

[NonPersistent]
public abstract class BaseObject :
    XPCustomObject

VB.NET

<NonPersistent>
Public MustInherit Class BaseObject
    Inherits XPCustomObject

Remarks

The BaseObject class is a feature-rich persistent base class. The BaseObject class is used as the base class when declaring business classes using the XPO Business Object template. The BaseObject class’s main features are:

• A GUID-type auto-generated BaseObject.Oid primary key property;
• Supports optimistic concurrency control;
• Supports deferred deletion.

The following example demonstrates how to declare a persistent class:

C#

using DevExpress.Persistent.Base;
using DevExpress.Persistent.BaseImpl;
using DevExpress.Xpo;
// ...
[DefaultClassOptions]
public class Contact : BaseObject {
    // BaseObject contains an auto-generated Guid key, you cannot add a custom key
    public Contact(Session session) : base(session) { }
    string fFirstName;
    public string FirstName {
        get { return fFirstName; }
        set { SetPropertyValue(nameof(FirstName), ref fFirstName, value); }
    }
}

VB.NET

Imports DevExpress.Persistent.Base
Imports DevExpress.Persistent.BaseImpl
Imports DevExpress.Xpo
' ...
<DefaultClassOptions()>
Public Class Contact
    Inherits BaseObject 
    ' BaseObject contains an auto-generated Guid key, you cannot add a custom key
    Public Sub New(ByVal session As Session)
        MyBase.New(session)
    End Sub
    Private fFirstName As String
    Public Property FirstName() As String
        Get
            Return fFirstName
        End Get
        Set(ByVal value as String)
            SetPropertyValue(NameOf(FirstName), fFirstName, value)
        End Set
    End Property
End Class

The following help topic lists base classes that you can use in XPO-based applications: Base Persistent Classes.

Business classes are inherited from a base persistent class. The Ways to Add a Business Class topic describes how to declare a business class, and the How to: Implement a Custom Base Persistent Class help topic provides details on how to implement a custom base persistent class. The Business Classes vs Database Tables topic provides a general overview of the business class concept.

Note

XAF manages persistent objects via Object Spaces. Refer to the BaseObjectSpace class description for more information about the Object Space concept.

Related GitHub Examples

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

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_validation-how-to-highlight-invalid-properties-when-the-view-is-shown-e1524/CS/DXSample.Module/TestObject.cs#L13

[DefaultClassOptions]
public class TestObject : BaseObject {
    public TestObject(Session session) : base(session) { }

VB.NET

XAF_validation-how-to-highlight-invalid-properties-when-the-view-is-shown-e1524/VB/DXSample.Module/TestObject.vb#L15

Public Class TestObject
    Inherits BaseObject
    Public Sub New(ByVal session As Session)

Inheritance

Show 13 items

Object

PersistentBase

XPBaseObject

XPCustomObject

BaseObject

DashboardData

MediaDataObject

ModelDifference

ModelDifferenceAspect

PermissionPolicyRoleBase

PermissionPolicyUser

ReportDataV2

PermissionPolicyRole