DictionaryBase.ICollection.SyncRoot Vlastnost

Definice

Obor názvů:

System.Collections

Sestavení:

netstandard.dll, System.Collections.NonGeneric.dll

Zdroj:

DictionaryBase.cs

Získá objekt, který lze použít k synchronizaci přístupu k objektu DictionaryBase .

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

object System.Collections.ICollection.SyncRoot { get; }

member this.System.Collections.ICollection.SyncRoot : obj

 ReadOnly Property SyncRoot As Object Implements ICollection.SyncRoot

Hodnota vlastnosti

Object

Objekt, který lze použít k synchronizaci přístupu k objektu DictionaryBase .

Implementuje

SyncRoot

Příklady

Následující příklad kódu ukazuje, jak uzamknout kolekci pomocí SyncRoot vlastnosti během celého výčtu.

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

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

Načtení hodnoty této vlastnosti je O(1) operace.

Poznámky

Odvozené třídy mohou poskytovat vlastní synchronizovanou verzi DictionaryBase třídy pomocí SyncRoot vlastnosti. Synchronizační kód musí provádět operace s SyncRoot vlastností objektu DictionaryBase , nikoli přímo na objektu DictionaryBase . Tím se zajistí správná operace kolekcí odvozených z jiných objektů. Konkrétně udržuje správnou synchronizaci s jinými vlákny, která mohou současně upravovat DictionaryBase objekt.

Výčet prostřednictvím kolekce není vnitřně bezpečným postupem pro přístup z více vláken. I když je kolekce synchronizována, ostatní vlákna mohou stále upravovat kolekci, což způsobí, že enumerátor vyvolá výjimku. Chcete-li zaručit bezpečnost vláken během výčtu, můžete buď uzamknout kolekci během celého výčtu, nebo zachytit výjimky vyplývající z změn provedených jinými vlákny.

Viz také

• IsSynchronized
• Synchronized(Hashtable)