NameObjectCollectionBase.KeysCollection.ICollection.SyncRoot Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u een object op dat kan worden gebruikt om de toegang tot het NameObjectCollectionBase.KeysCollectionobject te synchroniseren.
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 NameObjectCollectionBase.KeysCollection.
Implementeringen
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de verzameling vergrendelt met behulp van de SyncRoot gehele opsomming.
// Create a collection derived from NameObjectCollectionBase
NameObjectCollectionBase myBaseCollection = new DerivedCollection();
// Get the ICollection from NameObjectCollectionBase.KeysCollection
ICollection myKeysCollection = myBaseCollection.Keys;
lock(myKeysCollection.SyncRoot)
{
foreach (object item in myKeysCollection)
{
// Insert your code here.
}
}
' Create a collection derived from NameObjectCollectionBase
Dim myBaseCollection As NameObjectCollectionBase = New DerivedCollection()
' Get the ICollection from NameObjectCollectionBase.KeysCollection
Dim myKeysCollection As ICollection = myBaseCollection.Keys
SyncLock myKeysCollection.SyncRoot
For Each item As Object In myKeysCollection
' Insert your code here.
Next item
End SyncLock
Het ophalen van de waarde van deze eigenschap is een O(1)-bewerking.
Opmerkingen
Afgeleide klassen kunnen hun eigen gesynchroniseerde versie van de NameObjectCollectionBase.KeysCollectionSyncRoot eigenschap bieden. De synchronisatiecode moet bewerkingen uitvoeren op de van de SyncRootNameObjectCollectionBase.KeysCollection, niet rechtstreeks op de NameObjectCollectionBase.KeysCollection. 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 NameObjectCollectionBase.KeysCollection object mogelijk tegelijkertijd wijzigen.
Het inventariseren via een verzameling is intrinsiek geen thread-veilige 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.