Freigeben über


Stack.SyncRoot Eigenschaft

Definition

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

public:
 virtual property System::Object ^ SyncRoot { System::Object ^ get(); };
public virtual object SyncRoot { get; }
member this.SyncRoot : obj
Public Overridable ReadOnly Property SyncRoot As Object

Eigenschaftswert

Eine Object , die verwendet werden kann, um den Zugriff auf die Stack.

Implementiert

Hinweise

Verwenden Sie die Synchronized Methode, um eine synchronisierte Version der StackDatei zu erstellen. Abgeleitete Klassen können jedoch ihre eigene synchronisierte Version der Stack Eigenschaft SyncRoot bereitstellen. Der Synchronisierungscode muss Vorgänge für das SyncRootStack, nicht direkt auf der Stack. Dadurch wird der ordnungsgemäße Betrieb von Auflistungen sichergestellt, die von anderen Objekten abgeleitet werden. Insbesondere behält sie die ordnungsgemäße Synchronisierung mit anderen Threads bei, die Stack das Objekt möglicherweise gleichzeitig ändern.

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 gesamten Enumeration gesperrt wird.

Stack myCollection = new Stack();

lock (myCollection.SyncRoot)
{
    foreach (object item in myCollection)
    {
        // Insert your code here.
    }
}
Dim myCollection As New Stack()

SyncLock myCollection.SyncRoot
    For Each item As Object In myCollection
        ' Insert your code here.
    Next item
End SyncLock

Das Abrufen des Werts dieser Eigenschaft ist ein O(1) Vorgang.

Gilt für: