DictionaryBase.ICollection.SyncRoot Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso a un DictionaryBase oggetto .
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.SyncRootValore della proprietà
Oggetto che può essere utilizzato per sincronizzare l'accesso all'oggetto DictionaryBase .
Implementazioni
Esempio
Nell'esempio di codice seguente viene illustrato come bloccare la raccolta usando la SyncRoot proprietà durante l'intera enumerazione.
ICollection myCollection = new ShortStringDictionary();
lock(myCollection.SyncRoot)
{
foreach (Object item in myCollection)
{
// Insert your code here.
}
}
Dim myCollection As ICollection = New ShortStringDictionary()
SyncLock myCollection.SyncRoot
For Each item In myCollection
' Insert your code here.
Next item
End SyncLock
Il recupero del valore di questa proprietà è un'operazione O(1) .
Commenti
Le classi derivate possono fornire la propria versione sincronizzata della DictionaryBase classe usando la SyncRoot proprietà . Il codice di sincronizzazione deve eseguire operazioni sulla SyncRoot proprietà dell'oggetto DictionaryBase , non direttamente sull'oggetto DictionaryBase . In questo modo si garantisce il corretto funzionamento delle raccolte derivate da altri oggetti. In particolare, mantiene una corretta sincronizzazione con altri thread che potrebbero modificare contemporaneamente l'oggetto DictionaryBase .
L'enumerazione tramite una raccolta non è intrinsecamente una procedura thread-safe. Anche quando una raccolta viene sincronizzata, altri thread possono comunque modificare la raccolta, causando la generazione di un'eccezione da parte dell'enumeratore. Per garantire la thread safety durante l'enumerazione, è possibile bloccare la raccolta durante l'intera enumerazione o intercettare le eccezioni risultanti dalle modifiche apportate da altri thread.
