HybridDictionary.SyncRoot Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá objekt, který lze použít k synchronizaci přístupu k HybridDictionary.
public:
property System::Object ^ SyncRoot { System::Object ^ get(); };
public object SyncRoot { get; }
member this.SyncRoot : obj
Public ReadOnly Property SyncRoot As Object
Hodnota vlastnosti
Objekt, který lze použít k synchronizaci přístupu k objektu HybridDictionary.
Implementuje
Příklady
Následující příklad kódu ukazuje, jak uzamknout kolekci pomocí celého výčtu 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
Načtení hodnoty této vlastnosti je operace O(1).
Poznámky
Odvozené třídy mohou poskytovat vlastní synchronizovanou verzi HybridDictionary použití SyncRoot vlastnosti. Synchronizační kód musí provádět operace s SyncRootHybridDictionary, nikoli přímo na straně HybridDictionary. 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 HybridDictionary 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.