ListDictionary.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 ListDictionaryobject te synchroniseren.
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 ListDictionary.
Implementeringen
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de verzameling vergrendelt met behulp van de SyncRoot gehele opsomming.
ListDictionary myCollection = new ListDictionary();
lock(myCollection.SyncRoot)
{
foreach (object item in myCollection)
{
// Insert your code here.
}
}
Dim myCollection As New ListDictionary()
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.
Opmerkingen
Afgeleide klassen kunnen hun eigen gesynchroniseerde versie van de ListDictionarySyncRoot eigenschap bieden. De synchronisatiecode moet bewerkingen uitvoeren op de van de SyncRootListDictionary, niet rechtstreeks op de ListDictionary. 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 ListDictionary 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.