Hashtable.SyncRoot Propriété

Définition

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

public virtual object SyncRoot { get; }

Valeur de propriété

Objet qui peut être utilisé pour synchroniser l'accès à Hashtable.

Implémente

Remarques

Pour créer une version synchronisée de , Hashtableutilisez la Synchronized méthode . Toutefois, les classes dérivées peuvent fournir leur propre version synchronisée de à l’aide Hashtable de la SyncRoot propriété . Le code de synchronisation doit effectuer des opérations sur le SyncRootHashtabledu , et non directement sur le Hashtable. 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 Hashtable .

L’énumération par le biais d’une collection n’est pas intrinsèquement 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 du SyncRoot pendant toute l’énumération :

var myCollection = new Hashtable();
lock (myCollection.SyncRoot)
{
    foreach (object item in myCollection)
    {
        // Insert your code here.
    }
}

S’applique à

Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

Voir aussi