TreeNodeCollection.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, mit dem der Zugriff auf das TreeNodeCollection-Objekt synchronisiert werden kann.
public:
property System::Object ^ SyncRoot { System::Object ^ get(); };
public object SyncRoot { get; }
member this.SyncRoot : obj
Public ReadOnly Property SyncRoot As Object
Eigenschaftswert
Ein Object, mit dem der Zugriff auf die TreeNodeCollection synchronisiert werden kann.
Implementiert
Hinweise
Die SyncRoot -Eigenschaft stellt eine synchronisierte Version von bereit, die TreeNodeCollection mit Synchronisierungscode (Threading) verwendet werden kann.
Achtung
Die IsSynchronized Eigenschaft dieser Klasse gibt immer zurück false
, was angibt, dass die TreeNodeCollection Klasse nicht synchronisiert ist (nicht threadsicher).
Beim Synchronisieren von Code müssen Vorgänge für das SyncRoot -Objekt des ausgeführt werden, und nicht TreeNodeCollectiondirekt für das TreeNodeCollection objekt selbst. Dies gewährleistet die einwandfreie Funktion von Auflistungen, die von anderen Objekten abgeleitet sind. Insbesondere behält sie eine ordnungsgemäße Synchronisierung mit anderen Threads bei, die TreeNodeCollection das Objekt möglicherweise gleichzeitig ändern.
Hinweis
Das in dieser Implementierung zurückgegebene Objekt ist das Objekt, das System.Collections.ArrayList zum Speichern der TreeNode Objekte in der Auflistung verwendet wird.
Die Enumeration einer Auflistung ist systemintern keine threadsichere Prozedur. Selbst wenn eine Auflistung synchronisiert wird, können andere Threads die Auflistung weiterhin ändern, was dazu führt, 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.
Weitere Informationen zur SyncRoot -Eigenschaft finden Sie in der ICollection.SyncRoot Eigenschaft der System.Collections.ICollection Schnittstelle.