BeginUpdate Method (XmlExtensions)

Suspends notifications while massive changes are being made to an XML node and its descendants.

Syntax

Visual Basic
C#

'Declaration
 
Public Shared Sub BeginUpdate( _
   ByVal node As System.Xml.Linq.XContainer _
)

public static void BeginUpdate( 
   System.Xml.Linq.XContainer node
)

Parameters

node: The node that is the root of a tree where massive changes are made in code.

Remarks

This method must be followed by EndUpdate.

Use this method when you already have indexes over this XML or live views based on it, and you need to perform massive changes on the contents of this node and its descendants. Without this method, every single change you make causes LiveLinq to perform necessary operations for maintaining your indexes and live views dependent on this node and its descendants. In case of massive changes, this can be slower than to wait until the massive changes are done and rebuild the indexes and live views.

Between BeginUpdate and EndUpdate calls, indexes, live views, bound controls and other change notification listeners are not updated, they don't receive change notifications. When EndUpdate is called, a SourceChangeType.Reset notification is sent, meaning all indexes, live views and other collections dependent on this node and its descendants must be rebuilt from scratch.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

XmlExtensions Class
XmlExtensions Members