PropertyCollection.ICollection.SyncRoot Eigenschaft

Definition

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Quelle:

PropertyCollection.cs

Ruft ein Objekt ab, das zum Synchronisieren des Zugriffs auf die ICollectionverwendet werden kann.

property System::Object ^ System::Collections::ICollection::SyncRoot { System::Object ^ get(); };

object System.Collections.ICollection.SyncRoot { get; }

member this.System.Collections.ICollection.SyncRoot : obj

 ReadOnly Property SyncRoot As Object Implements ICollection.SyncRoot

Eigenschaftswert

Object

Ein Objekt, das zum Synchronisieren des Zugriffs auf die ICollection.

Implementiert

SyncRoot

Hinweise

Für Sammlungen, deren zugrunde liegender Speicher nicht öffentlich verfügbar ist, wird die erwartete Implementierung die aktuelle Instanz zurückgeben. Beachten Sie, dass der Zeiger auf die aktuelle Instanz für Sammlungen, die andere Auflistungen umschließen, möglicherweise nicht ausreicht; diese sollten die SyncRoot-Eigenschaft der zugrunde liegenden Auflistung zurückgeben.

Die meisten Sammlungsklassen im System.Collections Namespace implementieren auch eine Synchronized-Methode, die einen synchronisierten Wrapper um die zugrunde liegende Auflistung bereitstellt. Abgeleitete Klassen können jedoch ihre eigene synchronisierte Version der Auflistung mithilfe der SyncRoot Eigenschaft bereitstellen. Der Synchronisierungscode muss Vorgänge für die SyncRoot Auflistung ausführen, nicht direkt für die Auflistung. Dadurch wird der ordnungsgemäße Betrieb von Auflistungen sichergestellt, die von anderen Objekten abgeleitet werden. Insbesondere wird die ordnungsgemäße Synchronisierung mit anderen Threads beibehalten, die möglicherweise gleichzeitig die Sammlungsinstanz ändern.

Wenn keine Synchronized-Methode für eine Auflistung vorhanden ist, sieht die erwartete Verwendung SyncRoot wie folgt aus:

ICollection MyCollection =...
 lock(MyCollection.SyncRoot) {
  // Some operation on the collection, which is now thread safe.
 }

Dim myCollection as New ICollection()
 SyncLock myCollection.SyncRoot
  ' Some operation on the collection, which is now thread safe.
 End SyncLock

Das Aufzählen durch eine Sammlung ist in der Regel keine threadsichere Prozedur. Selbst wenn eine Auflistung synchronisiert wird, können andere Threads die Auflistung weiterhin ändern, wodurch der Enumerator eine Ausnahme auslöst. Um die Threadsicherheit während der Enumeration zu gewährleisten, können Sie die Auflistung entweder während der gesamten Enumeration sperren oder die Ausnahmen erfassen, die sich aus Änderungen ergeben, die von anderen Threads vorgenommen wurden.

Das folgende Codebeispiel zeigt, wie die Auflistung mithilfe der SyncRoot gesamten Enumeration gesperrt wird:

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

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

Weitere Informationen

• IsSynchronized