StringDictionary.SyncRoot Eigenschaft

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 StringDictionary.

Beispiele

Das folgende Codebeispiel zeigt, wie die Auflistung mithilfe der SyncRoot gesamten Enumeration gesperrt wird.

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

Dim myCollection As New StringDictionary()
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.

Hinweise

Abgeleitete Klassen können ihre eigene synchronisierte Version der StringDictionary Eigenschaft SyncRoot bereitstellen. Der Synchronisierungscode muss Vorgänge für das SyncRootStringDictionary, nicht direkt auf der StringDictionary. 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 StringDictionary 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.