SchemaNameCollection.ICollection.SyncRoot Eigenschaft

Definition

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

Quelle:

SchemaNameCollection.cs

Ruft ein Objekt ab, mit dem der Zugriff auf ICollection synchronisiert 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, mit dem der Zugriff auf ICollection synchronisiert werden kann.

Implementiert

SyncRoot

Hinweise

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

Die meisten Auflistungsklassen im System.Collections-Namespace implementieren darüber hinaus eine Synchronized-Methode, die einen synchronisierten Wrapper um die zugrunde liegende Auflistung zur Verfügung stellt. Abgeleitete Klassen können jedoch mithilfe der SyncRoot-Eigenschaft eine eigene synchronisierte Version der Auflistung bereitstellen. Der Synchronisierungscode muss Vorgänge für die SyncRoot -Auflistung und nicht direkt für die Auflistung ausführen. Dies gewährleistet die einwandfreie Funktion von Auflistungen, die von anderen Objekten abgeleitet sind. Im Besonderen wird die ordnungsgemäße Synchronisierung mit anderen Threads gewährleistet, die eventuell zur gleichen Zeit Änderungen an der Auflistungsinstanz vornehmen.

Wenn keine Synchronized Methode für eine Auflistung vorhanden ist, sieht die erwartete Verwendung für 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  

Die Enumeration einer Auflistung ist systemintern keine threadsichere Prozedur. Selbst wenn eine Auflistung synchronisiert wird, besteht die Möglichkeit, dass andere Threads sie ändern. Dies führt dazu, dass der Enumerator eine Ausnahme auslöst. Um während der Enumeration Threadsicherheit zu gewährleisten, können Sie entweder die Auflistung während der gesamten Enumeration sperren oder die Ausnahmen, die aus von anderen Threads stammenden Änderungen resultieren, abfangen.

Das folgende Beispiel zeigt, wie Die Auflistung während der gesamten Enumeration mit gesperrt wird SyncRoot :

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