Dictionary<TKey,TValue>.Remove Yöntem

Tanım

Ad Alanı:

System.Collections.Generic

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Collections.dll

Aşırı Yüklemeler

Name	Description
Remove(TKey)	belirtilen anahtara sahip değeri'nden Dictionary<TKey,TValue>kaldırır.
Remove(TKey, TValue)	belirtilen anahtara sahip değeri öğesinden Dictionary<TKey,TValue>kaldırır ve öğesini parametresine value kopyalar.

Remove(TKey)

Kaynak:

Dictionary.cs

belirtilen anahtara sahip değeri'nden Dictionary<TKey,TValue>kaldırır.

public:
 virtual bool Remove(TKey key);

public bool Remove(TKey key);

abstract member Remove : 'Key -> bool
override this.Remove : 'Key -> bool

Public Function Remove (key As TKey) As Boolean

Parametreler

key

TKey

Kaldırılacak öğenin anahtarı.

Döndürülenler

Boolean

true öğe başarıyla bulunur ve kaldırılırsa; aksi takdirde , false. Bu yöntem içinde falsebulunamazsa key döndürürDictionary<TKey,TValue>.

Uygulamalar

Remove(TKey)

Özel durumlar

ArgumentNullException

key, null'e eşittir.

Örnekler

Aşağıdaki kod örneği, yöntemini kullanarak bir anahtar/değer çiftinin sözlükten nasıl kaldırılacağını Remove gösterir.

Bu kod örneği, sınıfı için Dictionary<TKey,TValue> sağlanan daha büyük bir örneğin parçasıdır (openWith bu örnekte kullanılan Sözlüğün adıdır).

// Use the Remove method to remove a key/value pair.
Console.WriteLine("\nRemove(\"doc\")");
openWith.Remove("doc");

if (!openWith.ContainsKey("doc"))
{
    Console.WriteLine("Key \"doc\" is not found.");
}

// Use the Remove method to remove a key/value pair.
printfn "\nRemove(\"doc\")"
openWith.Remove "doc" |> ignore

if openWith.ContainsKey "doc" |> not then
    printfn "Key \"doc\" is not found."

' Use the Remove method to remove a key/value pair.
Console.WriteLine(vbLf + "Remove(""doc"")")
openWith.Remove("doc")

If Not openWith.ContainsKey("doc") Then
    Console.WriteLine("Key ""doc"" is not found.")
End If

Açıklamalar

Dictionary<TKey,TValue> belirtilen anahtara sahip bir öğe içermiyorsa, Dictionary<TKey,TValue> değişmeden kalır. İstisna atılmaz.

Bu yöntem bir O(1) işlemine yaklaşır.

Yalnızca .NET Core 3.0+ : Bu kapatma yöntemi, örnekteki etkin numaralandırıcılar Dictionary<TKey,TValue> geçersiz kılınmadan güvenli bir şekilde çağrılabilir. Bu, iş parçacığı güvenliği anlamına gelmez.

Ayrıca bkz.

• Add(TKey, TValue)
• Remove(TKey)

Remove(TKey, TValue)

Kaynak:

Dictionary.cs

belirtilen anahtara sahip değeri öğesinden Dictionary<TKey,TValue>kaldırır ve öğesini parametresine value kopyalar.

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

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

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

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

Parametreler

key

TKey

Kaldırılacak öğenin anahtarı.

value

TValue

Kaldırılan öğe.

Döndürülenler

Boolean

true öğe başarıyla bulunur ve kaldırılırsa; aksi takdirde , false.

Özel durumlar

ArgumentNullException

key, null'e eşittir.