Dictionary<TKey,TValue>.Remove 方法

定義

命名空間:

System.Collections.Generic

組件:

System.Collections.dll

多載

Remove(TKey)	將具有指定索引鍵的值從 Dictionary<TKey,TValue> 中移除。
Remove(TKey, TValue)	從 Dictionary<TKey,TValue> 中移除具有指定索引鍵的值，並將該項目複製到 value 參數。

Remove(TKey)

來源:

Dictionary.cs

將具有指定索引鍵的值從 Dictionary<TKey,TValue> 中移除。

C#

public bool Remove (TKey key);

參數

key

TKey

要移除的項目索引鍵。

傳回

Boolean

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

實作

Remove(TKey)

例外狀況

ArgumentNullException

key 為 null。

範例

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

此程式代碼範例是針對 Dictionary<TKey,TValue> 類別提供的較大範例的一部分， openWith (是本範例中使用的 Dictionary 名稱) 。

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

備註

Dictionary<TKey,TValue>如果 不包含具有指定索引鍵的專案，則 Dictionary<TKey,TValue> 會保持不變。 不會擲回任何例外狀況。

此方法會接近 O (1) 作業。

僅限 .NET Core 3.0+ ：這個變動方法可以安全地呼叫，而不會使實例上的作用中 Dictionary<TKey,TValue> 列舉值失效。 這並不表示線程安全。

另請參閱

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

Remove(TKey, TValue)

來源:

Dictionary.cs

從 Dictionary<TKey,TValue> 中移除具有指定索引鍵的值，並將該項目複製到 value 參數。

C#

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

參數

key

TKey

要移除的項目索引鍵。

value

TValue

已移除的項目。

傳回

Boolean

如果成功找到並移除項目則為 true，否則為 false。

例外狀況

ArgumentNullException

key 為 null。