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> 中移除。

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

參數

key

TKey

要移除的項目索引鍵。

傳回

Boolean

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

實作

Remove(TKey)

例外狀況

ArgumentNullException

key 為 null。

範例

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

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

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

備註

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 參數。

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

參數

key

TKey

要移除的項目索引鍵。

value

TValue

已移除的項目。

傳回

Boolean

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

例外狀況

ArgumentNullException

key 為 null。