Session.Save(Object) Method

Saves the specified persistent object to a data store.

Namespace: DevExpress.Xpo

Assembly: DevExpress.Xpo.v23.2.dll

NuGet Packages: DevExpress.Win.PivotGrid, DevExpress.Win.TreeMap, DevExpress.Xpo

NuGet Package: DevExpress.Xpo

Declaration

C#

public void Save(
    object theObject
)

VB.NET

Public Sub Save(
    theObject As Object
)

Parameters

Name	Type	Description
theObject	Object	An object which represents the persistent object to save.

Remarks

Below is an example of using the Save method. Here, session is the Session instance.

C#

Person personToUpdate = session.FindObject<Person>(CriteriaOperator.Parse("Name='Michael Suyama'"));
personToUpdate.Birthday = new DateTime(1986, 10, 31);
session.Save(personToUpdate);

VB.NET

Dim personToUpdate As Person = session.FindObject(Of Person)(CriteriaOperator.Parse("Name='Michael Suyama'"))
personToUpdate.Birthday = New Date(1986, 10, 31)
session.Save(personToUpdate)

The Save method also saves all the referenced objects that are aggregated (see the AggregatedAttribute topic for information) and any referenced newly created non-aggregated objects that don’t yet exist in the data store.

Note

The Save method saves the object immediately when the current persistent object is loaded using Session. If the UnitOfWork is used, the method marks the persistent object as modified and forces the UnitOfWork to include it into the further commit operation. UnitOfWork automatically collects new objects and tracks modified objects using the OnChanged method.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Save(Object) 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#

XPO_how-to-import-a-large-data-set-using-xpo-efficiently-within-a-transaction-t333879/CS/XpoImport/XpoImportHelper.cs#L33

    object obj = CreatePersistentObject(uow, current);
    uow.Save(obj);
}

XPO_how-to-create-persistent-classes-mapped-to-tables-with-a-composite-primary-key-at-runtime-e4606/CS/XpoConsoleApplication/Program.cs#L132

}
s.Save(o);
list.Add(o);

VB.NET

XPO_how-to-import-a-large-data-set-using-xpo-efficiently-within-a-transaction-t333879/VB/XpoImport/XpoImportHelper.vb#L33

    Dim obj As Object = CreatePersistentObject(uow, current)
    uow.Save(obj)
Next current