StringDictionary.SyncRoot プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

StringDictionary.SyncRoot プロパティ

StringDictionary へのアクセスを同期するために使用できるオブジェクトを取得します。

名前空間: System.Collections.Specialized
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Overridable ReadOnly
 Property SyncRoot As Object

Visual Basic (使用法)

Dim instance As StringDictionary
Dim value As Object

value = instance.SyncRoot

public virtual Object SyncRoot { get; }

C++

public:
virtual property Object^ SyncRoot {
    Object^ get ();
}

/** @property */
public Object get_SyncRoot ()

JScript

public function get SyncRoot
 () : Object

プロパティ値
StringDictionary へのアクセスを同期するために使用できる Object。

解説

派生クラスでは、SyncRoot プロパティを使用して、独自に StringDictionary を同期させることができます。コードによる同期操作は、StringDictionary で直接実行するのではなく、StringDictionary の SyncRoot で実行する必要があります。これにより、他のオブジェクトから派生したコレクションの操作が正常に実行されます。特に、StringDictionary オブジェクトを同時に変更する可能性がある別スレッドとの間で、正常な同期を維持します。

コレクションの列挙処理は、本質的にはスレッドセーフな処理ではありません。コレクションが同期されている場合でも、他のスレッドがそのコレクションを変更する可能性はあり、そのような状況が発生すると列挙子は例外をスローします。列挙処理を確実にスレッドセーフに行うには、列挙中にコレクションをロックするか、他のスレッドによって行われた変更によってスローされる例外をキャッチします。

使用例

列挙処理中に SyncRoot を使用してコレクションをロックする方法を次のコード例に示します。

StringDictionary myCollection = new StringDictionary();
  lock(myCollection.SyncRoot) {
  foreach (Object item in myCollection) {
  // Insert your code here.
  }
 }

Visual Basic

Dim myCollection As New
 StringDictionary()
 Dim item As Object
 SyncLock myCollection.SyncRoot
  For Each item In myCollection
  ' Insert your code here.
  Next item
 End SyncLock