Hashtable.Synchronized(Hashtable) Méthode

Définition

Espace de noms:

System.Collections

Assembly:

System.Runtime.dll

Source:

Hashtable.cs

Retourne un wrapper synchronisé (thread-safe) pour Hashtable.

C#

public static System.Collections.Hashtable Synchronized (System.Collections.Hashtable table);

Paramètres

table

Hashtable

Hashtable à synchroniser.

Retours

Hashtable

Wrapper synchronisé (thread-safe) pour Hashtable.

Exceptions

ArgumentNullException

table a la valeur null.

Exemples

L’exemple suivant montre comment synchroniser un Hashtable, déterminer si un Hashtable est synchronisé et utiliser un synchronisé Hashtable.

C#

using System;
using System.Collections;

public class SamplesHashtable2
{
    public static void Main()
    {
        // Creates and initializes a new Hashtable.
        var myHT = new Hashtable();
        myHT.Add(0, "zero");
        myHT.Add(1, "one");
        myHT.Add(2, "two");
        myHT.Add(3, "three");
        myHT.Add(4, "four");

        // Creates a synchronized wrapper around the Hashtable.
        Hashtable mySyncdHT = Hashtable.Synchronized(myHT);

        // Displays the sychronization status of both Hashtables.
        Console.WriteLine("myHT is {0}.", myHT.IsSynchronized ? "synchronized" : "not synchronized");
        Console.WriteLine("mySyncdHT is {0}.", mySyncdHT.IsSynchronized ? "synchronized" : "not synchronized");
    }
}

/*
This code produces the following output.

myHT is not synchronized.
mySyncdHT is synchronized.
*/

Remarques

La Synchronized méthode est thread safe pour plusieurs lecteurs et rédacteurs. En outre, le wrapper synchronisé garantit qu’il n’y a qu’un seul rédacteur en écriture à la fois.

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 pendant SyncRoot toute l’énumération :

C#

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

Cette méthode est une O(1) opération.

S’applique à

Voir aussi

• IsSynchronized
• SyncRoot