IDictionary<TKey,TValue>.Remove(TKey) 方法

定義

命名空間:

System.Collections.Generic

組件:

System.Runtime.dll

從 IDictionary<TKey,TValue> 中移除具有指定之索引鍵的項目。

public:
 bool Remove(TKey key);

public bool Remove (TKey key);

abstract member Remove : 'Key -> bool

Public Function Remove (key As TKey) As Boolean

參數

key

TKey

要移除的項目索引鍵。

傳回

Boolean

如果成功移除項目，則為 true，否則為 false。 如果在原始的 false 中找不到 key，則這個方法也會傳回 IDictionary<TKey,TValue>。

例外狀況

ArgumentNullException

key 為 null。

NotSupportedException

IDictionary<TKey,TValue> 為唯讀。

範例

下列程式代碼範例示範如何使用 方法，從字典 Remove 中移除索引鍵/值組。

此程式代碼是可編譯和執行之較大範例的一部分。 請參閱 System.Collections.Generic.IDictionary<TKey,TValue>。

// 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

備註

實作可能會因判斷物件的相等方式而有所不同;例如， List<T> 類別會使用 Comparer<T>.Default，而 Dictionary<TKey,TValue> 類別可讓使用者指定要 IComparer<T> 用於比較索引鍵的實作。

另請參閱

• IsReadOnly