Dictionary<TKey,TValue>.Remove Yöntem

Tanım

Ad Alanı:

System.Collections.Generic

Bütünleştirilmiş Kod:

System.Collections.dll

Aşırı Yüklemeler

Remove(TKey)	belirtilen anahtara sahip değeri değerinden 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 değerinden 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 Dictionary<TKey,TValue>bulunamazsa key döndürürfalse.

Uygulamalar

Remove(TKey)

Özel durumlar

ArgumentNullException

key, null değeridir.

Ö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.
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.
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. Özel durum oluşturulmaz.

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

Yalnızca .NET Core 3.0+ : Bu mutating 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 değeridir.