SchedulerStorageBase.BeginUpdate() Method

Locks the object until the EndUpdate or CancelUpdate method is called.

Namespace: DevExpress.XtraScheduler

Assembly: DevExpress.XtraScheduler.v19.1.Core.dll

Declaration

C#

public void BeginUpdate()

VB.NET

Public Sub BeginUpdate

Remarks

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.

Important

In DevExpress versions prior to 18.1, calling the BeginUpdate method caused the storage to reload its item collection from a data source. Starting with version 18.1, this behavior has been changed and items are not reloaded until the SchedulerStorageBase.EndUpdate is called.

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#

how-to-export-appointments-with-custom-fields-to-vcalendar-format-e638/CS/VCalendarCustomFields/Form1.cs#L35

schedulerStorage1.BeginUpdate();
DateTime currentDate;

show-alert-notifications-of-only-appointments-that-are-associated-with-the-current-user-e3212/CS/ExampleUtils.cs#L16

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

icalendar-export-import-of-appointments-in-the-specified-interval-containing-custom-objects-e547/CS/iCalendarExportImport/Form1.cs#L38

schedulerStorage1.BeginUpdate();
DateTime currentDate;

how-to-customize-visual-elements-using-scheduler-services-e1006/CS/CustomFormats/Code/Helpers.cs#L19

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

how-to-merge-adjacent-appointments-together-e2056/CS/SnapAdjacentAppointments/Form1.cs#L34

{
    schedulerStorage1.BeginUpdate();
    for (int i = 0; i < 2; i++)

VB.NET

how-to-export-appointments-with-custom-fields-to-vcalendar-format-e638/VB/VCalendarCustomFields/Form1.vb#L41

schedulerStorage1.BeginUpdate()
Dim currentDate As Date

show-alert-notifications-of-only-appointments-that-are-associated-with-the-current-user-e3212/VB/ExampleUtils.vb#L17

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

icalendar-export-import-of-appointments-in-the-specified-interval-containing-custom-objects-e547/VB/iCalendarExportImport/Form1.vb#L40

schedulerStorage1.BeginUpdate()
Dim currentDate As Date

how-to-customize-visual-elements-using-scheduler-services-e1006/VB/CustomFormats/Code/Helpers.vb#L19

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

how-to-merge-adjacent-appointments-together-e2056/VB/SnapAdjacentAppointments/Form1.vb#L32

Private Sub CreateAppointments()
    schedulerStorage1.BeginUpdate()
    For i As Integer = 0 To 1