Hashtable.SyncRoot プロパティ
Hashtable へのアクセスを同期するために使用できるオブジェクトを取得します。
Public Overridable ReadOnly Property SyncRoot As Object Implements _ ICollection.SyncRoot
[C#]
public virtual object SyncRoot {get;}
[C++]
public: __property virtual Object* get_SyncRoot();
[JScript]
public function get SyncRoot() : Object;
プロパティ値
Hashtable へのアクセスを同期するために使用できるオブジェクト。
実装
解説
同期した Hashtable を作成するには、 Synchronized メソッドを使用します。ただし、派生クラスでは、 SyncRoot プロパティを使用して、独自に Hashtable を同期させることができます。プログラム コードによる同期操作は、 Hashtable で直接実行するのではなく、 Hashtable の SyncRoot で実行する必要があります。これにより、他のオブジェクトから派生したコレクションの操作が正常に実行されます。特に、 Hashtable オブジェクトを同時に変更する可能性がある別スレッドとの間で、正常な同期を維持します。
コレクションの列挙処理は、本質的にはスレッド セーフな処理ではありません。コレクションが同期されている場合でも、他のスレッドがそのコレクションを変更する可能性はあり、そのような状況が発生すると列挙子は例外をスローします。列挙処理を確実にスレッド セーフに行うには、列挙中にコレクションをロックするか、他のスレッドによって行われた変更によってスローされる例外をキャッチする方法のいずれかを実行できます。
[Visual Basic, C#] 列挙処理中に SyncRoot を使用してコレクションをロックする方法を次のコード例に示します。
Hashtable myCollection = new Hashtable();
lock( myCollection.SyncRoot ) {
foreach ( Object item in myCollection ) {
// Insert your code here.
}
}
[Visual Basic]
Dim myCollection As New Hashtable()
Dim item As Object
SyncLock myCollection.SyncRoot
For Each item In myCollection
' Insert your code here.
Next item
End SyncLock
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard
参照
Hashtable クラス | Hashtable メンバ | System.Collections 名前空間 | IsSynchronized | Synchronized