ICollection.SyncRoot-Eigenschaft

Object SyncRoot { get; }

/** @property */
Object get_SyncRoot ()

function get SyncRoot () : Object

Eigenschaftenwert

Bei Auflistungen, die einen nicht öffentlich verfügbaren Speicher verwenden, wird eine Implementierung erwartet, die die aktuelle Instanz zurückgibt. Beachten Sie, dass der Zeiger auf die aktuelle Instanz eventuell nicht ausreichend ist bei Auflistungen, die andere Auflistungen enthalten. Hier sollte die SyncRoot-Eigenschaft der zugrunde liegenden Auflistung zurückgegeben werden.

Die meisten Auflistungsklassen im Namespace System.Collections 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. Im Synchronisierungscode dürfen Vorgänge nicht direkt für die Auslistung ausgeführt werden. Stattdessen müssen sie für die SyncRoot-Eigenschaft der Auflistung ausgeführt werden. 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 in einer Auflistung keine Synchronized-Methode zur Verfügung steht, sollte SyncRoot wie folgt verwendet werden:

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

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. Sie können während der Enumeration Threadsicherheit gewährleisten, indem Sie entweder die Auflistung während der gesamten Enumeration sperren oder die Ausnahmen abfangen, die durch Änderungen anderer Threads ausgelöst werden.

Im folgenden Codebeispiel wird veranschaulicht, wie die Auflistung mithilfe der SyncRoot-Eigenschaft während der gesamten Enumeration gesperrt wird.

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

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

.NET Compact Framework