ReadOnlyCollectionBase.ICollection.SyncRoot Propriété

Définition

Obtient un objet qui peut être utilisé pour synchroniser l'accès à un objet ReadOnlyCollectionBase.

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

Valeur de propriété

Object

Objet pouvant être utilisé pour synchroniser l’accès à l’objet ReadOnlyCollectionBase.

Implémente

Exemples

L’exemple de code suivant montre comment verrouiller la collection à l’aide de la SyncRoot propriété pendant toute l’énumération.

// Get the ICollection interface from the ReadOnlyCollectionBase
// derived class.
ICollection^ myCollection = myReadOnlyCollection;
bool lockTaken = false;
try
{
    Monitor::Enter(myCollection->SyncRoot, lockTaken);
    for each (Object^ item in myCollection);
    {
        // Insert your code here.
    }
}
finally
{
    if (lockTaken)
    {
        Monitor::Exit(myCollection->SyncRoot);
    }
}
// Get the ICollection interface from the ReadOnlyCollectionBase
// derived class.
ICollection myCollection = myReadOnlyCollection;
lock(myCollection.SyncRoot)
{
    foreach (object item in myCollection)
    {
        // Insert your code here.
    }
}
' Get the ICollection interface from the ReadOnlyCollectionBase
' derived class.
Dim myCollection As ICollection = myReadOnlyCollection
SyncLock myCollection.SyncRoot
    For Each item As Object In myCollection
        ' Insert your code here.
    Next item
End SyncLock

La récupération de la valeur de cette propriété est une O(1) opération.

Remarques

Les classes dérivées peuvent fournir leur propre version synchronisée de la ReadOnlyCollectionBase classe à l’aide de la SyncRoot propriété. Le code de synchronisation doit effectuer des opérations sur la SyncRoot propriété de l' ReadOnlyCollectionBase objet, et non directement sur l' ReadOnlyCollectionBase objet. Cela garantit un bon fonctionnement des collections dérivées d’autres objets. Plus précisément, il maintient une synchronisation appropriée avec d’autres threads qui peuvent modifier simultanément l' ReadOnlyCollectionBase objet.

L'énumération d'une collection n'est intrinsèquement pas une procédure thread-safe. Même lorsqu'une collection est synchronisée, les autres threads peuvent toujours la modifier, ce qui entraîne la levée d'une exception par l'énumérateur. Pour garantir la sécurité des threads au cours de l’énumération, vous pouvez verrouiller la collection pendant l’ensemble de l’énumération ou bien intercepter les exceptions résultant des modifications apportées par les autres threads.

S’applique à

Voir aussi