DictionaryBase.ICollection.IsSynchronized DictionaryBase.ICollection.IsSynchronized DictionaryBase.ICollection.IsSynchronized Property

Définition

Obtient une valeur indiquant si l'accès à un objet DictionaryBase est synchronisé (thread-safe).Gets a value indicating whether access to a DictionaryBase object is synchronized (thread safe).

property bool System::Collections::ICollection::IsSynchronized { bool get(); };
bool System.Collections.ICollection.IsSynchronized { get; }
 ReadOnly Property IsSynchronized As Boolean Implements ICollection.IsSynchronized

Valeur de propriété

true si l'accès à l'objet DictionaryBase est synchronisé (thread-safe) ; sinon, false.true if access to the DictionaryBase object is synchronized (thread safe); otherwise, false. La valeur par défaut est false.The default is false.

Implémente

Exemples

L’exemple de code suivant montre comment verrouiller la collection à l’aide de la propriété SyncRoot pendant toute l’énumération.The following code example shows how to lock the collection using the SyncRoot property during the entire enumeration.

ICollection^ myCollection = gcnew ShortStringDictionary();
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);
    }
}
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

La récupération de la valeur de cette propriété est une opération O(1).Retrieving the value of this property is an O(1) operation.

Remarques

Un objet DictionaryBase n’est pas synchronisé.A DictionaryBase object is not synchronized. Les classes dérivées peuvent fournir une version synchronisée de la classe DictionaryBase à l’aide de la propriété SyncRoot.Derived classes can provide a synchronized version of the DictionaryBase class using the SyncRoot property.

L'énumération d'une collection n'est intrinsèquement pas une procédure thread-safe.Enumerating through a collection is intrinsically not a thread-safe procedure. 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.Even when a collection is synchronized, other threads can still modify the collection, which causes the enumerator to throw an exception. 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.To guarantee thread safety during enumeration, you can either lock the collection during the entire enumeration or catch the exceptions resulting from changes made by other threads.

S’applique à

Voir aussi