StringCollection.SyncRoot Eigenschap

public:
 property System::Object ^ SyncRoot { System::Object ^ get(); };

public object SyncRoot { get; }

member this.SyncRoot : obj

Public ReadOnly Property SyncRoot As Object

Waarde van eigenschap

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

Implementeringen

Opmerkingen

Afgeleide klassen kunnen hun eigen gesynchroniseerde versie van de StringCollectionSyncRoot eigenschap bieden. De synchronisatiecode moet bewerkingen uitvoeren op de van de SyncRootStringCollection, niet rechtstreeks op de StringCollection. 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 StringCollection 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:

StringCollection myCollection = new StringCollection();
lock(myCollection.SyncRoot)
{
    foreach (object item in myCollection)
    {
        // Insert your code here.
    }
}

Dim myCollection As New StringCollection()
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