HybridDictionary.SyncRoot Właściwość

Definicja

Przestrzeń nazw:

System.Collections.Specialized

Zestaw:

System.Collections.Specialized.dll

Źródło:

HybridDictionary.cs

Pobiera obiekt, który może służyć do synchronizowania dostępu do obiektu HybridDictionary.

public:
 property System::Object ^ SyncRoot { System::Object ^ get(); };

public object SyncRoot { get; }

member this.SyncRoot : obj

Public ReadOnly Property SyncRoot As Object

Wartość właściwości

Object

Obiekt, który może służyć do synchronizowania dostępu do obiektu HybridDictionary.

Implementuje

SyncRoot

Przykłady

W poniższym przykładzie kodu pokazano, jak zablokować kolekcję przy użyciu SyncRoot elementu podczas całego wyliczenia.

HybridDictionary^ myCollection = gcnew HybridDictionary();
bool lockTaken = false;
try
{
    Monitor::Enter(myCollection->SyncRoot, lockTaken);
    for each (Object^ item in myCollection)
    {
        // Insert your code here.
    }
}
finally
{
    if (lockTaken)
    {
        Monitor::Exit(myCollection->SyncRoot);
    }
}

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

Dim myCollection As New HybridDictionary()
SyncLock myCollection.SyncRoot
    For Each item In myCollection
        ' Insert your code here.
    Next
End SyncLock

Pobieranie wartości tej właściwości jest operacją O(1).

Uwagi

Klasy pochodne mogą udostępniać własną zsynchronizowaną wersję HybridDictionary obiektu przy użyciu SyncRoot właściwości . Synchronizowanie kodu musi wykonywać operacje na obiekcie SyncRootHybridDictionary, a nie bezpośrednio w obiekcie HybridDictionary. Gwarantuje to prawidłowe funkcjonowanie kolekcji, które są uzyskiwane z innych obiektów. W szczególności utrzymuje właściwą synchronizację z innymi wątkami, które mogą jednocześnie modyfikować HybridDictionary obiekt.

Wyliczanie w kolekcji nie jest wewnętrznie procedurą odporną na wielowątkowość. Nawet gdy kolekcja jest synchronizowana, inne wątki nadal mogą ją modyfikować. Powoduje to zgłaszanie wyjątku przez moduł wyliczający. Aby zagwarantować bezpieczeństwo wątków podczas wyliczania, można zablokować kolekcję podczas całego procesu wyliczania albo rejestrować wyjątki wynikłe ze zmian wprowadzanych przez inne wątków.

Zobacz też

• IsSynchronized