ConcurrentDictionary<TKey,TValue>.TryRemove Метод

Определение

Пространство имен:

System.Collections.Concurrent

Сборка:

System.Collections.Concurrent.dll

Перегрузки

TryRemove(TKey, TValue)	Пытается удалить и вернуть значение с указанным ключом из коллекции ConcurrentDictionary<TKey,TValue>.
TryRemove(KeyValuePair<TKey,TValue>)	Удаляет ключ и значение из словаря.

TryRemove(TKey, TValue)

Исходный код:

ConcurrentDictionary.cs

Пытается удалить и вернуть значение с указанным ключом из коллекции ConcurrentDictionary<TKey,TValue>.

public:
 bool TryRemove(TKey key, [Runtime::InteropServices::Out] TValue % value);

public bool TryRemove (TKey key, out TValue value);

member this.TryRemove : 'Key * 'Value -> bool

Public Function TryRemove (key As TKey, ByRef value As TValue) As Boolean

Параметры

key

TKey

Ключ удаляемого и возвращаемого элемента.

value

TValue

При возврате этого метода содержит объект, удаленный ConcurrentDictionary<TKey,TValue>из , или значение TValue по умолчанию типа , если key он не существует.

Возвращаемое значение

Boolean

Значение true, если объект успешно удален; в противном случае — значение false.

Исключения

ArgumentNullException

key имеет значение null.

Примеры

В следующем примере показано, как вызвать ConcurrentDictionary<TKey,TValue>.TryRemove метод :

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!");
        }
}

// Demonstrates:
//      ConcurrentDictionary<TKey, TValue>.TryAdd()
//      ConcurrentDictionary<TKey, TValue>.TryUpdate()
//      ConcurrentDictionary<TKey, TValue>.TryRemove()

let mutable numFailures = 0 // for bookkeeping

// Construct an empty dictionary
let cd = ConcurrentDictionary<int, string>()

// This should work
if cd.TryAdd(1, "one") |> not then
    printfn "CD.TryAdd() failed when it should have succeeded"
    numFailures <- numFailures + 1

// This shouldn't work -- key 1 is already in use
if cd.TryAdd(1, "uno") then
    printfn "CD.TryAdd() succeeded when it should have failed"
    numFailures <- numFailures + 1

// Now change the value for key 1 from "one" to "uno" -- should work
if cd.TryUpdate(1, "uno", "one") |> not then
    printfn "CD.TryUpdate() failed when it should have succeeded"
    numFailures <- numFailures + 1

// 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") then
    printfn "CD.TryUpdate() succeeded when it should have failed"
    numFailures <- numFailures + 1

// Remove key/value for key 1.  Should work.
let mutable value1 = ""

if cd.TryRemove(1, &value1) |> not then
    printfn "CD.TryRemove() failed when it should have succeeded"
    numFailures <- numFailures + 1

// Remove key/value for key 1.  Shouldn't work, because I already removed it
let mutable value2 = ""

if cd.TryRemove(1, &value2) then
    printfn "CD.TryRemove() succeeded when it should have failed"
    numFailures <- numFailures + 1

// If nothing went wrong, say so
if numFailures = 0 then
    printfn "  OK!"

'Imports System.Collections.Concurrent

Class CD_TryXYZ

    ' Demonstrates:
    ' ConcurrentDictionary<TKey, TValue>.TryAdd()
    ' ConcurrentDictionary<TKey, TValue>.TryUpdate()
    ' ConcurrentDictionary<TKey, TValue>.TryRemove()
    Shared Sub Main()
        Dim numFailures As Integer = 0
        ' for bookkeeping
        ' Construct an empty dictionary
        Dim cd As ConcurrentDictionary(Of Integer, [String]) = New ConcurrentDictionary(Of Integer, String)()

        ' This should work
        If Not cd.TryAdd(1, "one") Then
            Console.WriteLine("CD.TryAdd() failed when it should have succeeded")
            numFailures += 1
        End If

        ' This shouldn't work -- key 1 is already in use
        If cd.TryAdd(1, "uno") Then
            Console.WriteLine("CD.TryAdd() succeeded when it should have failed")
            numFailures += 1
        End If

        ' Now change the value for key 1 from "one" to "uno" -- should work
        If Not cd.TryUpdate(1, "uno", "one") Then
            Console.WriteLine("CD.TryUpdate() failed when it should have succeeded")
            numFailures += 1
        End If

        ' 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") Then
            Console.WriteLine("CD.TryUpdate() succeeded when it should have failed")
            numFailures += 1
        End If

        ' Remove key/value for key 1. Should work.
        Dim value1 As String = ""
        If Not cd.TryRemove(1, value1) Then
            Console.WriteLine("CD.TryRemove() failed when it should have succeeded")
            numFailures += 1
        End If

        ' Remove key/value for key 1. Shouldn't work, because I already removed it
        Dim value2 As String = ""
        If cd.TryRemove(1, value2) Then
            Console.WriteLine("CD.TryRemove() succeeded when it should have failed")
            numFailures += 1
        End If

        ' If nothing went wrong, say so
        If numFailures = 0 Then
            Console.WriteLine(" OK!")
        End If
    End Sub
End Class

См. также раздел

• Потокобезопасные коллекции
• Практическое руководство. Добавление элементов в коллекцию ConcurrentDictionary и их удаление из этой коллекции

TryRemove(KeyValuePair<TKey,TValue>)

Исходный код:

ConcurrentDictionary.cs

Удаляет ключ и значение из словаря.

public:
 bool TryRemove(System::Collections::Generic::KeyValuePair<TKey, TValue> item);

public bool TryRemove (System.Collections.Generic.KeyValuePair<TKey,TValue> item);

member this.TryRemove : System.Collections.Generic.KeyValuePair<'Key, 'Value> -> bool

Public Function TryRemove (item As KeyValuePair(Of TKey, TValue)) As Boolean

Параметры

item

KeyValuePair<TKey,TValue>

KeyValuePair<TKey,TValue> представляет ключ и значение для удаления.

Возвращаемое значение

Boolean

Значение true, если ключ и значение, представленные item, найдены и удалены; в противном случае значение false.

Исключения

ArgumentNullException

Свойство Key параметра item равно null.

Комментарии

Для удаления указанного ключа и значения должны совпадать с записью в словаре.

Ключ сравнивается с помощью компаратора словаря (или сравнения по умолчанию для TKey , если при его создании в словаре не было предоставлено средство сравнения). Значение сравнивается с помощью средства сравнения по умолчанию для TValue.