BeginUpdate メソッド (XmlExtensions)

XML ノードとその子孫に大規模な変更が行われている間、通知を一時停止します。

シンタックス

Visual Basic
C#

'宣言
 
<System.Runtime.CompilerServices.ExtensionAttribute()>
Public Shared Sub BeginUpdate( _
   ByVal node As System.Xml.Linq.XContainer _
)

[System.Runtime.CompilerServices.Extension()]
public static void BeginUpdate( 
   System.Xml.Linq.XContainer node
)

パラメータ

node: 大規模な変更がコード内で行われるツリーのルートであるノード。

解説

このメソッドの後には、 XmlExtensions.EndUpdateが必要です。

このメソッドは、既にこの XML またはそれに基づくライブビューにインデックスがあり、このノードおよびその子孫のコンテンツに対して大規模な変更を行う必要がある場合に使用します。このメソッドを使用しない場合は、個々の変更のたびに、このノードと子孫に依存するインデックスとライブビューを維持するために必要な操作が実行されます。これは、大規模な変更の場合、変更が完了してインデックスとライブビューがリビルドされるまで待機するよりも遅くなります。

BeginUpdate呼び出しから XmlExtensions.EndUpdate呼び出しまでの間、インデックス、ライブビュー、連結コントロール、その他の変更通知リスナーは更新されず、変更通知を受け取りません。 XmlExtensions.EndUpdateが呼び出されると、 SourceChangeType.Reset通知が送信され、このノードと子孫に依存するすべてのインデックス、ライブビュー、その他のコレクションを最初からリビルドする必要があることが示されます。

参照

XmlExtensions クラス
 XmlExtensions メンバ