NameObjectCollectionBase.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 à l’objet NameObjectCollectionBase 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 à l'objet NameObjectCollectionBase est synchronisé (thread-safe) ; sinon, false. La valeur par défaut est false.

Implémente

IsSynchronized

Remarques

Un NameObjectCollectionBase objet n’est pas synchronisé. Les classes dérivées peuvent fournir une version synchronisée du à l’aide NameObjectCollectionBase de la SyncRoot propriété .

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.

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

// Create a collection derived from NameObjectCollectionBase
ICollection^ myCollection = gcnew DerivedCollection();
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);
    }
}

// Create a collection derived from NameObjectCollectionBase
ICollection myCollection = new DerivedCollection();
lock(myCollection.SyncRoot)
{
    foreach (object item in myCollection)
    {
        // Insert your code here.
    }
}

' Create a collection derived from NameObjectCollectionBase
Dim myCollection As ICollection = New DerivedCollection()
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 opération O(1).

Voir aussi

• SyncRoot