Dictionary<TKey,TValue>.Remove メソッド

定義

オーバーロード

Remove(TKey)

指定したキーを持つ値を Dictionary<TKey,TValue> から削除します。

Remove(TKey, TValue)

指定されたキーを持つ値を Dictionary<TKey,TValue> から削除し、その要素を value パラメーターにコピーします。

Remove(TKey)

ソース:
Dictionary.cs
ソース:
Dictionary.cs
ソース:
Dictionary.cs

指定したキーを持つ値を Dictionary<TKey,TValue> から削除します。

public bool Remove (TKey key);

パラメーター

key
TKey

削除する要素のキー。

戻り値

要素が見つかり、正常に削除された場合は true。それ以外の場合は false。 このメソッドは、keyDictionary<TKey,TValue> に見つからない場合、false を返します。

実装

例外

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

注釈

Dictionary<TKey,TValue> 指定したキーを持つ要素が含まれていない場合、 Dictionary<TKey,TValue> は変更されません。 例外はスローされません。

このメソッドは O(1) 操作に近づく。

.NET Core 3.0 以降のみ: この変更メソッドは、インスタンスのアクティブな列挙子を無効にせずに安全に Dictionary<TKey,TValue> 呼び出される場合があります。 これはスレッド セーフを意味するものではありません。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Remove(TKey, TValue)

ソース:
Dictionary.cs
ソース:
Dictionary.cs
ソース:
Dictionary.cs

指定されたキーを持つ値を Dictionary<TKey,TValue> から削除し、その要素を value パラメーターにコピーします。

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

パラメーター

key
TKey

削除する要素のキー。

value
TValue

削除された要素。

戻り値

要素が見つかり、正常に削除された場合は true。それ以外の場合は false

例外

keynullです。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1