Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Expand]Controls and Libraries
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Collapse]API Reference
  [Expand]DevExpress.Charts.Designer
  [Expand]DevExpress.Data
  [Expand]DevExpress.Mvvm.UI
  [Expand]DevExpress.Mvvm.UI.Interactivity
  [Expand]DevExpress.Mvvm.UI.ModuleInjection
  [Expand]DevExpress.Xpf.Accordion
  [Collapse]DevExpress.Xpf.Bars
   [Expand]AddBarAction Class
   [Expand]AddBarItemAction Class
   [Expand]AddBarItemLinkAction Class
   [Expand]Bar Class
   [Expand]BarActionBase Class
   [Expand]BarButtonItem Class
   [Expand]BarButtonItemLink Class
   [Expand]BarCheckItem Class
   [Expand]BarCheckItemLink Class
   [Expand]BarCollection Class
   [Expand]BarContainerControl Class
    BarContainerType Enumeration
   [Expand]BarDockInfo Class
   [Expand]BarEditItem Class
   [Expand]BarEditItemLink Class
   [Expand]BarItem Class
   [Expand]BarItemActionBase Class
    BarItemAlignment Enumeration
    BarItemAutoSizeMode Enumeration
   [Collapse]BarItemCollection Class
     BarItemCollection Members
     BarItemCollection Constructor
    [Expand]BarItemCollection Properties
    [Expand]BarItemCollection Events
    [Collapse]BarItemCollection Methods
      BeginUpdate Method
      EndUpdate Method
    BarItemDisplayMode Enumeration
   [Expand]BarItemLink Class
   [Expand]BarItemLinkActionBase Class
   [Expand]BarItemLinkBase Class
   [Expand]BarItemLinkCollection Class
   [Expand]BarItemLinkHolderBase Class
   [Expand]BarItemLinkMenuHeader Class
   [Expand]BarItemLinkSeparator Class
   [Expand]BarItemMenuHeader Class
    BarItemMergeType Enumeration
   [Expand]BarItemSeparator Class
   [Expand]BarLinkContainerItem Class
   [Expand]BarLinkContainerItemLink Class
   [Expand]BarListItem Class
   [Expand]BarListItemLink Class
   [Expand]BarManager Class
   [Expand]BarManagerActionCollection Class
   [Expand]BarManagerActionContainer Class
   [Expand]BarManagerCategory Class
   [Expand]BarManagerCategoryCollection Class
   [Expand]BarManagerController Class
   [Expand]BarManagerControllerActionBase Class
   [Expand]BarManagerControllerBase Class
   [Expand]BarNameScope Class
   [Expand]BarPopupBase Class
   [Expand]BarsLocalizer Class
   [Expand]BarSplitButtonItem Class
   [Expand]BarSplitButtonItemLink Class
   [Expand]BarSplitCheckItem Class
   [Expand]BarSplitCheckItemLink Class
   [Expand]BarStaticItem Class
   [Expand]BarStaticItemLink Class
   [Expand]BarSubItem Class
   [Expand]BarSubItemLink Class
    ButtonSwitcher Enumeration
   [Expand]CreateStandardLayoutAction Class
    ElementMergingBehavior Enumeration
   [Expand]Gallery Class
    GalleryCheckDrawMode Enumeration
   [Expand]GalleryControl Class
   [Expand]GalleryItem Class
    GalleryItemCheckMode Enumeration
   [Expand]GalleryItemCollection Class
   [Expand]GalleryItemGroup Class
   [Expand]GalleryItemGroupCollection Class
    GallerySizeMode Enumeration
    GlyphSize Enumeration
   [Expand]IControllerAction Interface
   [Expand]ILinksHolder Interface
   [Expand]InsertAction Class
   [Expand]InsertBarAction Class
   [Expand]InsertBarItemAction Class
   [Expand]InsertBarItemLinkAction Class
   [Expand]InsertMainMenuIfNotExistAction Class
   [Expand]InsertStatusBarIfNotExistAction Class
   [Expand]ItemClickEventArgs Class
    ItemClickEventHandler Delegate
    ItemLinksHolderType Enumeration
   [Expand]LayoutUpgradingEventArgs Class
    LayoutUpgradingEventHandler Delegate
   [Expand]LinkListItem Class
   [Expand]LinkListItemLink Class
   [Expand]MainMenuControl Class
    MDIMergeStyle Enumeration
   [Expand]MergingProperties Class
   [Expand]PopupControlContainer Class
   [Expand]PopupControlContainerInfo Class
   [Expand]PopupInfo<PopupType> Class
   [Expand]PopupMenu Class
   [Expand]PopupMenuBase Class
   [Expand]PopupMenuInfo Class
    PopupMenuItemsDisplayMode Enumeration
   [Expand]RadialContextMenu Class
   [Expand]RemoveAction Class
   [Expand]RemoveBarAction Class
   [Expand]RemoveBarItemAction Class
   [Expand]RemoveBarItemAndLinkAction Class
   [Expand]RemoveBarItemLinkAction Class
   [Expand]ReplaceAction Class
    RibbonItemStyles Enumeration
   [Expand]SetBarAction Class
   [Expand]SetBarItemAction Class
   [Expand]SetBarItemLinkAction Class
   [Expand]StatusBarControl Class
   [Expand]TemplatedBarManagerController Class
   [Expand]ToolBarControl Class
   [Expand]ToolBarControlBase Class
   [Expand]ToolbarListItem Class
   [Expand]ToolbarListItemLink Class
    ToolbarListItemType Enumeration
    ToolBarMergeStyle Enumeration
   [Expand]UpdateAction Class
   [Expand]UpdateBarAction Class
   [Expand]UpdateBarItemAction Class
   [Expand]UpdateBarItemLinkAction Class
   [Expand]UpdateBarItemLinkActionBase Class
  [Expand]DevExpress.Xpf.Carousel
  [Expand]DevExpress.Xpf.Charts
  [Expand]DevExpress.Xpf.Charts.Localization
  [Expand]DevExpress.Xpf.Charts.RangeControlClient
  [Expand]DevExpress.Xpf.ChunkList
  [Expand]DevExpress.Xpf.Controls
  [Expand]DevExpress.Xpf.Core
  [Expand]DevExpress.Xpf.Core.ConditionalFormatting
  [Expand]DevExpress.Xpf.Core.DataSources
  [Expand]DevExpress.Xpf.Core.ServerMode
  [Expand]DevExpress.Xpf.Data
  [Expand]DevExpress.Xpf.DataAccess
  [Expand]DevExpress.Xpf.DataAccess.DataSourceWizard
  [Expand]DevExpress.Xpf.Diagram
  [Expand]DevExpress.Xpf.Dialogs
  [Expand]DevExpress.Xpf.Docking
  [Expand]DevExpress.Xpf.Docking.Base
  [Expand]DevExpress.Xpf.DocumentViewer
  [Expand]DevExpress.Xpf.DXBinding
  [Expand]DevExpress.Xpf.Editors
  [Expand]DevExpress.Xpf.Editors.DataPager
  [Expand]DevExpress.Xpf.Editors.DateNavigator
  [Expand]DevExpress.Xpf.Editors.ExpressionEditor
  [Expand]DevExpress.Xpf.Editors.ExpressionEditor.Native
  [Expand]DevExpress.Xpf.Editors.Filtering
  [Expand]DevExpress.Xpf.Editors.Flyout
  [Expand]DevExpress.Xpf.Editors.Flyout.Native
  [Expand]DevExpress.Xpf.Editors.Helpers
  [Expand]DevExpress.Xpf.Editors.Popups
  [Expand]DevExpress.Xpf.Editors.RangeControl
  [Expand]DevExpress.Xpf.Editors.Settings
  [Expand]DevExpress.Xpf.Editors.Validation
  [Expand]DevExpress.Xpf.ExpressionEditor
  [Expand]DevExpress.Xpf.Gauges
  [Expand]DevExpress.Xpf.Gauges.Localization
  [Expand]DevExpress.Xpf.Grid
  [Expand]DevExpress.Xpf.Grid.ConditionalFormatting
  [Expand]DevExpress.Xpf.Grid.LookUp
  [Expand]DevExpress.Xpf.Grid.TreeList
  [Expand]DevExpress.Xpf.Layout.Core
  [Expand]DevExpress.Xpf.LayoutControl
  [Expand]DevExpress.Xpf.Map
  [Expand]DevExpress.Xpf.NavBar
  [Expand]DevExpress.Xpf.Navigation
  [Expand]DevExpress.Xpf.PdfViewer
  [Expand]DevExpress.Xpf.PivotGrid
  [Expand]DevExpress.Xpf.PivotGrid.Printing
  [Expand]DevExpress.Xpf.Printing
  [Expand]DevExpress.Xpf.Printing.Parameters
  [Expand]DevExpress.Xpf.Printing.Parameters.Models
  [Expand]DevExpress.Xpf.Printing.PreviewControl
  [Expand]DevExpress.Xpf.Printing.PreviewControl.Bars
  [Expand]DevExpress.Xpf.Prism
  [Expand]DevExpress.Xpf.PropertyGrid
  [Expand]DevExpress.Xpf.Reports.UserDesigner
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Extensions
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Localization
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard.Pages
  [Expand]DevExpress.Xpf.Ribbon
  [Expand]DevExpress.Xpf.RichEdit
  [Expand]DevExpress.Xpf.RichEdit.Menu
  [Expand]DevExpress.Xpf.Scheduler
  [Expand]DevExpress.Xpf.Scheduler.Drawing
  [Expand]DevExpress.Xpf.Scheduler.Menu
  [Expand]DevExpress.Xpf.Scheduler.Reporting
  [Expand]DevExpress.Xpf.Scheduler.UI
  [Expand]DevExpress.Xpf.Scheduling
  [Expand]DevExpress.Xpf.Scheduling.Editors
  [Expand]DevExpress.Xpf.Scheduling.Reporting
  [Expand]DevExpress.Xpf.Scheduling.Visual
  [Expand]DevExpress.Xpf.Scheduling.VisualData
  [Expand]DevExpress.Xpf.SpellChecker
  [Expand]DevExpress.Xpf.Spreadsheet
  [Expand]DevExpress.Xpf.Spreadsheet.Menu
  [Expand]DevExpress.Xpf.TreeMap
  [Expand]DevExpress.Xpf.Utils.Themes
  [Expand]DevExpress.Xpf.WindowsUI
  [Expand]DevExpress.Xpf.WindowsUI.Internal
  [Expand]DevExpress.Xpf.WindowsUI.Navigation
  [Expand]DevExpress.XtraRichEdit
  [Expand]DevExpress.XtraRichEdit.Printing
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

BarItemCollection.BeginUpdate Method

Locks the BarItemCollection by preventing change notifications from being fired, preventing visual updates until the EndUpdate method is called.

Namespace:DevExpress.Xpf.Bars
Assembly:DevExpress.Xpf.Core.v18.1.dll

Expanded Syntax

Expanded Remarks

Use BeginUpdate along with the EndUpdate method to prevent superfluous change notifications from being sent while performing multiple changes on the BarItemCollection. Enclose the code that performs multiple changes on the collection with the BeginUpdate and EndUpdate methods. The result will be that the change notification will fire only once, triggered by the EndUpdate method.

The BeginUpdate and EndUpdate methods use an internal counter to implement the update functionality. The counter's initial value is 0. The BeginUpdate method increments the counter. EndUpdate decrements the counter, and if its new value is zero, change notification is enabled. Note that each call to BeginUpdate must be paired with a call to EndUpdate. If you call BeginUpdate but forget to call EndUpdate afterwards or EndUpdate is not called because an exception occurred, change notifications will no longer be fired. To ensure that EndUpdate is always called even if an exception occurs, use the try...finally statement.

After the BeginUpdate method is called for the first time, the OnBeginUpdate event fires. After a counterpart EndUpdate method has been called and the changes made have been applied, the OnEndUpdate event fires.

Expanded See Also

Is this topic helpful?​​​​​​​