SchedulerStorage.BeginUpdate() Method

Locks the SchedulerStorage, preventing visual updates of the object and its elements until the EndUpdate or CancelUpdate method is called.

Namespace: DevExpress.Xpf.Scheduler

Assembly: DevExpress.Xpf.Scheduler.v18.2.dll

Declaration

C#

public void BeginUpdate()

VB.NET

Public Sub BeginUpdate

Remarks

Important

You are viewing documentation for the legacy WPF Scheduler control. If you’re starting a new project, we strongly recommend that you use a new control declared in the DevExpress.Xpf.Scheduling namespace. If you decide to upgrade an existing project in order to switch to the updated scheduler control, see the Migration Guidelines document.

Call the BeginUpdate method to maintain performance while applying multiple modifications to the object. After the BeginUpdate method the IsUpdateLocked property returns false to prevent other processes from modifying the object or retrieving its properties. After applying all modifications, call the EndUpdate or CancelUpdate method to finalize the update or cancel it.

Each call to BeginUpdate must be paired with a call to EndUpdate or CancelUpdate. To ensure that EndUpdate/CancelUpdate is always called even if an exception occurs, enclose them in the try…finally statement.

Related GitHub Examples

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

dxscheduler-getting-started-create-a-custom-edit-appointment-form-e2499/CS/SchedulerCustomAppointmentForm/CustomAppointmentForm.xaml.cs#L44

// Save all changes made to the appointment.
Controller.Control.Storage.BeginUpdate();
Controller.ApplyChanges();

end-user-restrictions-how-to-define-availability-intervals-for-different-resources-e4673/CS/MainWindow.xaml.cs#L50

ResourceStorage resources = storage.ResourceStorage;
storage.BeginUpdate();
try {

how-to-handle-key-press-events-in-the-schedulercontrol-e2906/CS/DXScheduler_KeyHandling/ResourceFiller.cs#L18

ResourceCollection resources = storage.ResourceStorage.Items;
storage.BeginUpdate();
try {

VB.NET

how-to-split-appointments-into-groups-e3792/VB/MainWindow.xaml.vb#L36

RemoveHandler Storage.AppointmentChanging, AddressOf Storage_AppointmentChanging
Storage.BeginUpdate()
For i As Integer = 0 To Storage.AppointmentStorage.Count - 1

dxscheduler-getting-started-create-a-custom-edit-appointment-form-e2499/VB/SchedulerCustomAppointmentForm/CustomAppointmentForm.xaml.vb#L76

' Save all changes made to the appointment.
Controller.Control.Storage.BeginUpdate()
Controller.ApplyChanges()

end-user-restrictions-how-to-define-availability-intervals-for-different-resources-e4673/VB/MainWindow.xaml.vb#L52

Dim resources As ResourceStorage = storage.ResourceStorage
storage.BeginUpdate()
Try

how-to-handle-key-press-events-in-the-schedulercontrol-e2906/VB/DXScheduler_KeyHandling/ResourceFiller.vb#L16

Dim resources As ResourceCollection = storage.ResourceStorage.Items
storage.BeginUpdate()
Try