CollectionBase.ICollection.SyncRoot Eigenschap

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

Waarde van eigenschap

Een object dat kan worden gebruikt om de toegang tot de CollectionBase.

Implementeringen

Opmerkingen

Afgeleide klassen kunnen hun eigen gesynchroniseerde versie van de CollectionBaseSyncRoot eigenschap bieden. De synchronisatiecode moet bewerkingen uitvoeren op de van de SyncRootCollectionBase, niet rechtstreeks op de CollectionBase. Dit zorgt voor de juiste werking van verzamelingen die zijn afgeleid van andere objecten. Het onderhoudt met name de juiste synchronisatie met andere threads die het CollectionBase object mogelijk tegelijkertijd wijzigen.

Het inventariseren via een verzameling is intrinsiek geen threadveilige procedure. Zelfs wanneer een verzameling wordt gesynchroniseerd, kunnen andere threads de verzameling nog steeds wijzigen, waardoor de enumerator een uitzondering genereert. Om de veiligheid van threads tijdens de inventarisatie te garanderen, kunt u de verzameling vergrendelen tijdens de volledige inventarisatie of de uitzonderingen ondervangen die het gevolg zijn van wijzigingen die door andere threads zijn aangebracht.

In het volgende codevoorbeeld ziet u hoe u de verzameling vergrendelt met behulp van SyncRoot de volledige opsomming:

// Get the ICollection interface from the CollectionBase
// derived class.
ICollection myCollection = myCollectionBase;
lock(myCollection.SyncRoot)
{
    foreach (object item in myCollection)
    {
        // Insert your code here.
    }
}

' Get the ICollection interface from the CollectionBase
' derived class.
Dim myCollection As ICollection = myCollectionBase
SyncLock myCollection.SyncRoot
    For Each item As Object In myCollection
        ' Insert your code here.
    Next item
End SyncLock

Het ophalen van de waarde van deze eigenschap is een O(1) bewerking.

Zie ook

• IsSynchronized