NameObjectCollectionBase.KeysCollection.ICollection.IsSynchronized Propriété

Définition

Espace de noms:

System.Collections.Specialized

Assembly:

System.Collections.Specialized.dll

Source:

NameObjectCollectionBase.cs

Obtient une valeur indiquant si l’accès à NameObjectCollectionBase.KeysCollection est synchronisé (thread-safe).

property bool System::Collections::ICollection::IsSynchronized { bool get(); };

bool System.Collections.ICollection.IsSynchronized { get; }

member this.System.Collections.ICollection.IsSynchronized : bool

 ReadOnly Property IsSynchronized As Boolean Implements ICollection.IsSynchronized

Valeur de propriété

Boolean

true si l'accès à NameObjectCollectionBase.KeysCollection est synchronisé (thread-safe) ; sinon false. La valeur par défaut est false.

Implémente

IsSynchronized

Exemples

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

// Create a collection derived from NameObjectCollectionBase
NameObjectCollectionBase^ myBaseCollection = gcnew DerivedCollection();
// Get the ICollection from NameObjectCollectionBase.KeysCollection
ICollection^ myKeysCollection = myBaseCollection->Keys;
bool lockTaken = false;
try
{
    Monitor::Enter(myKeysCollection->SyncRoot, lockTaken);
    for each (Object^ item in myKeysCollection)
    {
        // Insert your code here.
    }
}
finally
{
    if (lockTaken)
    {
        Monitor::Exit(myKeysCollection->SyncRoot);
    }
}

// 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

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

Remarques

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

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.

Voir aussi

• IsSynchronized