ForEachItem.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 alla raccolta.
public:
property System::Object ^ SyncRoot { System::Object ^ get(); };
public object SyncRoot { get; }
member this.SyncRoot : obj
Public ReadOnly Property SyncRoot As Object
Valore della proprietà
Oggetto che può essere utilizzato per sincronizzare l'accesso alla raccolta.
Implementazioni
Esempio
Nell'esempio di codice seguente viene illustrato come bloccare una ArrayList raccolta utilizzando l'oggetto SyncRoot durante l'enumerazione.
using System;
using System.Collections;
ArrayList myCollection = new ArrayList();
lock( myCollection.SyncRoot )
foreach ( Object item in myCollection )
{
// Insert your code here.
}
Imports System
Imports System.Collections
Dim myCollection As ArrayList = New ArrayList()
lock(myCollection.SyncRoot)
For Each item In myCollection
' Insert your code here.
Next
Commenti
Implementa ICollection. IsSynchronized. Se si crea una raccolta personalizzata e la deriva da DTSReadOnlyCollectionBase , è possibile fornire la propria versione sincronizzata della raccolta usando la SyncRoot Proprietà. Il codice di sincronizzazione deve eseguire operazioni sull'oggetto SyncRoot della raccolta, non direttamente sulla raccolta. In questo modo si garantisce il corretto funzionamento delle raccolte derivate da altri oggetti. In particolare, mantiene la sincronizzazione corretta con altri thread che potrebbero modificare contemporaneamente l'oggetto.
L'enumerazione di una raccolta non è di per sé una procedura thread-safe. Anche quando una raccolta è sincronizzata, altri thread possono comunque modificare la raccolta, causando la generazione di un'eccezione da parte dell'enumeratore. Per garantire la protezione dei thread durante l'enumerazione, è possibile bloccare la raccolta per l'intera enumerazione oppure intercettare le eccezioni determinate dalle modifiche apportate da altri thread. Per ulteriori informazioni, vedere ICollection. IsSynchronized.