Dictionary<TKey,TValue>.Remove 메서드

정의

네임스페이스:

System.Collections.Generic

어셈블리:

System.Collections.dll

오버로드

Remove(TKey)	Dictionary<TKey,TValue>에서 지정한 키가 있는 값을 제거합니다.
Remove(TKey, TValue)	Dictionary<TKey,TValue>에서 지정된 키를 갖는 값을 제거하고, value 매개 변수에 요소를 복사합니다.

Remove(TKey)

Source:

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입니다. 이 메서드는 key가 Dictionary<TKey,TValue>에 없는 경우 false을 반환합니다.

구현

Remove(TKey)

예외

ArgumentNullException

key이(가) null인 경우

예제

다음 코드 예제에서는 메서드를 사용 하 여 사전에서 키/값 쌍을 제거 하는 방법에 설명 합니다 Remove .

이 코드 예제는 클래스에 Dictionary<TKey,TValue> 대해 제공되는 더 큰 예제의 일부입니다(openWith 이 예제에서 사용되는 사전의 이름임).

// 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> 변경되지 않은 상태로 유지됩니다. 예외는 throw되지 않습니다.

이 메서드는 O(1) 작업에 접근합니다.

.NET Core 3.0 이상만 해당: 이 변경 메서드는 instance 활성 열거자를 Dictionary<TKey,TValue> 무효화하지 않고 안전하게 호출될 수 있습니다. 스레드 안전을 의미하지는 않습니다.

추가 정보

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

Remove(TKey, TValue)

Source:

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인 경우