ConcurrentDictionary<TKey,TValue>.TryAdd(TKey, TValue) Méthode

Définition

Espace de noms:

System.Collections.Concurrent

Assembly:

System.Collections.Concurrent.dll

Source:

ConcurrentDictionary.cs

Tente d'ajouter la clé et la valeur spécifiées à ConcurrentDictionary<TKey,TValue>.

C#

public bool TryAdd (TKey key, TValue value);

Paramètres

key

TKey

Clé de l'élément à ajouter.

value

TValue

Valeur de l'élément à ajouter. La valeur peut être null pour les types référence.

Retours

Boolean

true si la paire clé/valeur a été ajoutée correctement au ConcurrentDictionary<TKey,TValue>. false si la clé existe déjà.

Exceptions

ArgumentNullException

key a la valeur null.

OverflowException

Le dictionnaire contient trop d’éléments.

Exemples

L’exemple suivant montre comment appeler la ConcurrentDictionary<TKey,TValue>.TryAdd méthode :

C#

class CD_TryXYZ
{
        // Demonstrates:
        //      ConcurrentDictionary<TKey, TValue>.TryAdd()
        //      ConcurrentDictionary<TKey, TValue>.TryUpdate()
        //      ConcurrentDictionary<TKey, TValue>.TryRemove()
        static void Main()
        {
            int numFailures = 0; // for bookkeeping

            // Construct an empty dictionary
            ConcurrentDictionary<int, String> cd = new ConcurrentDictionary<int, string>();

            // This should work
            if (!cd.TryAdd(1, "one"))
            {
                Console.WriteLine("CD.TryAdd() failed when it should have succeeded");
                numFailures++;
            }

            // This shouldn't work -- key 1 is already in use
            if (cd.TryAdd(1, "uno"))
            {
                Console.WriteLine("CD.TryAdd() succeeded when it should have failed");
                numFailures++;
            }

            // Now change the value for key 1 from "one" to "uno" -- should work
            if (!cd.TryUpdate(1, "uno", "one"))
            {
                Console.WriteLine("CD.TryUpdate() failed when it should have succeeded");
                numFailures++;
            }

            // Try to change the value for key 1 from "eine" to "one"
            //    -- this shouldn't work, because the current value isn't "eine"
            if (cd.TryUpdate(1, "one", "eine"))
            {
                Console.WriteLine("CD.TryUpdate() succeeded when it should have failed");
                numFailures++;
            }

            // Remove key/value for key 1.  Should work.
            string value1;
            if (!cd.TryRemove(1, out value1))
            {
                Console.WriteLine("CD.TryRemove() failed when it should have succeeded");
                numFailures++;
            }

            // Remove key/value for key 1.  Shouldn't work, because I already removed it
            string value2;
            if (cd.TryRemove(1, out value2))
            {
                Console.WriteLine("CD.TryRemove() succeeded when it should have failed");
                numFailures++;
            }

            // If nothing went wrong, say so
            if (numFailures == 0) Console.WriteLine("  OK!");
        }
}

Remarques

Cette méthode retourne false si la clé existe déjà. Utilisez la TryUpdate méthode ou AddOrUpdate pour mettre à jour la valeur si une clé existe déjà.

S’applique à

Voir aussi

• Collections thread-safe
• Guide pratique pour ajouter et supprimer des éléments d'un ConcurrentDictionary