ListDictionary.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 ListDictionary.
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 ListDictionary.
Implementuje
Příklady
Následující příklad kódu ukazuje, jak uzamknout kolekci pomocí celého výčtu SyncRoot .
ListDictionary myCollection = new ListDictionary();
lock(myCollection.SyncRoot)
{
foreach (object item in myCollection)
{
// Insert your code here.
}
}
Dim myCollection As New ListDictionary()
SyncLock myCollection.SyncRoot
For Each item as Object In myCollection
' Insert your code here.
Next item
End SyncLock
Načtení hodnoty této vlastnosti je operace O(1).
Poznámky
Odvozené třídy mohou poskytovat vlastní synchronizovanou verzi ListDictionary použití SyncRoot vlastnosti. Synchronizační kód musí provádět operace s SyncRootListDictionary, nikoli přímo na straně ListDictionary. 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 ListDictionary 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.