ForEachItems.SyncRoot プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ForEachItems コレクションへのアクセスを同期するために使用できるオブジェクトを取得します。
public:
property System::Object ^ SyncRoot { System::Object ^ get(); };
public object SyncRoot { get; }
member this.SyncRoot : obj
Public ReadOnly Property SyncRoot As Object
プロパティ値
ForEachItems コレクションへのアクセスの同期に使用できるオブジェクトです。
実装
例
次のコード例では、SyncRoot を使用して列挙の間 ArrayList
コレクションをロックします。
using System;
using System.Collections;
ArrayList myCollection = new ArrayList();
lock( myCollection.SyncRoot )
foreach ( Object item in myCollection )
{
// Insert your code here.
}
Imports System
Imports System.Collections
Dim myCollection As ArrayList = New ArrayList()
lock(myCollection.SyncRoot)
For Each item In myCollection
' Insert your code here.
Next
注釈
ICollection.IsSynchronized を実装します。 DTSReadOnlyCollectionBase から派生したカスタム コレクションを作成している場合は、SyncRoot プロパティを使用して、同期されたコレクションを独自に提供することができます。 同期コードでは、コレクションを直接操作するのではなく、コレクションの SyncRoot に対して操作を行う必要があります。 こうすることにより、他のオブジェクトから派生したコレクションを適切に操作することができます。 特に、オブジェクトを同時に変更している可能性がある他のスレッドとの同期が適切に保たれます。
コレクションの列挙処理は、本質的にスレッドセーフな処理ではありません。 コレクションが同期されている場合でも、他のスレッドがコレクションを変更する場合があるため、列挙子が例外をスローする原因になります。 列挙処理を確実にスレッド セーフに行うには、列挙中にコレクションをロックするか、他のスレッドによって行われた変更によってスローされる例外をキャッチします。 詳細については、「 ICollection.IsSynchronized」を参照してください。