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)

Syntax

'Declaration
ReadOnly Property SyncRoot As Object

Object SyncRoot { get; }

property Object^ SyncRoot {
    Object^ get ();
}

abstract SyncRoot : Object with get

function get SyncRoot () : Object

Property Value

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

Remarks

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.

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see dd66cd4c-b087-415f-9c3e-94e3a1835f74.

See Also

Reference

ICollection Interface

System.Collections Namespace