SyncRoot Property

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Gets an object that can be used to synchronize access to the ICollection.

Namespace:  System.Collections
Assembly:  mscorlib (in mscorlib.dll)

Object SyncRoot { get; }

Property Value

Type: System..::..Object
An object that can be used to synchronize access to the ICollection.

For collections whose underlying store is not publicly available, the expected implementation is to return the current instance. Note that the pointer to the current instance might not be sufficient for collections that wrap other collections; those should return the underlying collection's SyncRoot property.

Most collection classes in the System.Collections namespace also implement a Synchronized method, which provides a synchronized wrapper around the underlying collection. However, derived classes can provide their own synchronized version of the collection using the SyncRoot property. The synchronizing code must perform operations on the SyncRoot property of the collection, not directly on the collection. This ensures proper operation of collections that are derived from other objects. Specifically, it maintains proper synchronization with other threads that might be simultaneously modifying the collection instance.

Show: