xpo-devexpress-dot-xpo-7d45c4f2.md
Maintains a list of persistent objects that are affected by a transaction. Keeps track of every change to every persistent object during a transaction that can affect a data store.
Namespace : DevExpress.Xpo
Assembly : DevExpress.Xpo.v25.2.dll
NuGet Package : DevExpress.Xpo
public class UnitOfWork :
Session
Public Class UnitOfWork
Inherits Session
Unit of Work maintains a list of persistent objects that are affected by a transaction. It keeps track of every change to every persistent object during a transaction that can affect a data store. With a single call to the UnitOfWork.CommitChanges method, all the changes made to the persistent objects are automatically saved to a data store. When working with common sessions, you need to save each persistent object individually.
Unit of Work inherit the base functionality from the Session class and provide the UnitOfWork.CommitChanges method that is used to save all changed persistent objects to a data store. The only requirement for this is that the property setters call the XPBaseObject.OnChanged method. To simplify things, you can call the SetPropertyValue method to meet the requirement, as shown in the Create a Persistent Object article.
using(UnitOfWork uow = new UnitOfWork()) {
// Create a new object within a Unit of Work
Person p = new Person(uow);
p.Name = "Bob";
p.Location = "U.S.";
// Save all the changes made
uow.CommitChanges();
}
Dim uow As UnitOfWork = New UnitOfWork()
' Create a new object within a Unit of Work
Dim p As Person = new Person(uow)
p.Name = "Bob"
p.Location = "U.S."
' Save all the changes made
uow.CommitChanges()
uow.Dispose()
using(UnitOfWork uow = new UnitOfWork()) {
// Get a single item by its key
var p = uow.GetObjectByKey<Person>(key);
// Get all the items
var allPersons = uow.Query<Person>().ToList();
// Get all the items whose Person.Position property value is "Employee"
var employees = uow.Query<Person>().Where(x => x.Position == "Employee").ToList();
// Save all the changes made
uow.CommitChanges();
}
Using uow As UnitOfWork = New UnitOfWork()
' Get a single item by its key
Dim p = uow.GetObjectByKey(Of Person)(key)
' Get all the items
Dim allPersons = uow.Query(Of Person)().ToList()
' Get all the items whose Person.Position property value is "Employee"
Dim employees = uow.Query(Of Person)().Where(Function(x) x.Position Is "Employee").ToList()
' Save all the changes made
uow.CommitChanges()
End Using
using(UnitOfWork uow = new UnitOfWork()) {
// Get a single item by its key
var p = uow.GetObjectByKey<Person>(key);
// Modify a requested data item
p.Name = "Alice";
// Save all the changes made
uow.CommitChanges();
}
Using uow As UnitOfWork = New UnitOfWork()
' Get a single item by its key
Dim p = uow.GetObjectByKey(Of Person)(key)
' Modify a requested data item
p.Name = "Alice"
' Save all the changes made
uow.CommitChanges()
End Using
using(UnitOfWork uow = new UnitOfWork()) {
// Get a single item by its key
var p = uow.GetObjectByKey<Person>(key);
// Delete a single data item
p.Delete();
// Get all the items whose Person.Position property value is "Employee"
var employees = uow.Query<Person>().Where(x => x.Position == "Employee").ToList();
// Delete a collection of data items
uow.Delete(employees);
// Save all the changes made
uow.CommitChanges();
}
Using uow As UnitOfWork = New UnitOfWork()
' Get a single item by its key
Dim p = uow.GetObjectByKey(Of Person)(key)
' Delete a single data item
p.Delete()
' Get all the items whose Person.Position property value is "Employee"
Dim employees = uow.Query(Of Person)().Where(Function(x) x.Position Is "Employee").ToList()
' Delete a collection of data items
uow.Delete(employees)
' Save all the changes made
uow.CommitChanges()
End Using
Object MarshalByRefObject Component Session UnitOfWork ExplicitUnitOfWork
See Also