Dictionary<TKey,TValue>.Remove 메서드

정의

네임스페이스:

System.Collections.Generic

어셈블리:

System.Collections.dll

어셈블리:

mscorlib.dll

어셈블리:

netstandard.dll

오버로드

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

제거할 요소의 키입니다.

반환

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 이상만 해당: 인스턴스에서 활성 열거자를 무효화하지 않고 이 변경 메서드를 안전하게 호출할 수 있습니다 Dictionary<TKey,TValue> . 스레드 안전성을 의미하지는 않습니다.

추가 정보

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

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

제거된 요소입니다.

반환

Boolean

요소를 성공적으로 찾아서 제거한 경우 true이고, 그렇지 않으면 false입니다.

예외

ArgumentNullException

key이(가) null인 경우