ICollection.SyncRoot Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft ein Objekt ab, das zum Synchronisieren des Zugriffs auf die ICollectionverwendet werden kann.
public:
property System::Object ^ SyncRoot { System::Object ^ get(); };public object SyncRoot { get; }member this.SyncRoot : objPublic ReadOnly Property SyncRoot As ObjectEigenschaftswert
Ein Objekt, das zum Synchronisieren des Zugriffs auf die ICollection.
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 Eigenschaft der zugrunde liegenden Auflistung SyncRoot 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 Eigenschaft der 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 Methode für eine Synchronized Auflistung vorhanden ist, sieht die erwartete Verwendung wie SyncRoot folgt aus:
ICollection myCollection = someCollection;
lock(myCollection.SyncRoot)
{
// Some operation on the collection, which is now thread safe.
}
Dim myCollection As ICollection = someCollection
SyncLock myCollection.SyncRoot
' Some operation on the collection, which is now thread safe.
End SyncLock
Das Aufzählen durch eine Sammlung ist in erster Linie 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 Eigenschaft während der gesamten Enumeration gesperrt wird.
ICollection myCollection = someCollection;
lock(myCollection.SyncRoot)
{
foreach (object item in myCollection)
{
// Insert your code here.
}
}
Dim myCollection As ICollection = someCollection
SyncLock myCollection.SyncRoot
For Each item In myCollection
' Insert your code here.
Next item
End SyncLock
