Dictionary<TKey,TValue>.Remove 方法

定義

多載

Remove(TKey)

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

Remove(TKey, TValue)

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

Remove(TKey)

將具有指定索引鍵的值從 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

要移除的項目索引鍵。

傳回

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

實作

例外狀況

keynull

範例

下列程式碼範例示範如何使用 方法,從字典 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> 列舉值失效。 這並不表示執行緒安全性。

另請參閱

適用於

Remove(TKey, TValue)

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

已移除的項目。

傳回

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

例外狀況

keynull

適用於