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

定義

命名空間:

System.Collections.Generic

組件:

System.Runtime.dll

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

C#

public bool Remove (TKey key);

參數

key

TKey

要移除的項目索引鍵。

傳回

Boolean

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

例外狀況

ArgumentNullException

key 為 null。

NotSupportedException

IDictionary<TKey,TValue> 為唯讀。

範例

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

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

C#

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

備註

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

適用於

另請參閱

• IsReadOnly