Dictionary<TKey,TValue>.Remove 메서드

정의

오버로드

Remove(TKey)

Dictionary<TKey,TValue>에서 지정한 키가 있는 값을 제거합니다.Removes the value with the specified key from the Dictionary<TKey,TValue>.

Remove(TKey, TValue)

Dictionary<TKey,TValue>에서 지정된 키를 갖는 값을 제거하고, value 매개 변수에 요소를 복사합니다.Removes the value with the specified key from the Dictionary<TKey,TValue>, and copies the element to the value parameter.

Remove(TKey)

Dictionary<TKey,TValue>에서 지정한 키가 있는 값을 제거합니다.Removes the value with the specified key from the 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

제거할 요소의 키입니다.The key of the element to remove.

반환

Boolean

요소를 성공적으로 찾아서 제거한 경우 true이고, 그렇지 않으면 false입니다.true if the element is successfully found and removed; otherwise, false. 이 메서드는 keyDictionary<TKey,TValue>에 없는 경우 false을 반환합니다.This method returns false if key is not found in the Dictionary<TKey,TValue>.

구현

예외

key이(가) null인 경우.key is null.

예제

다음 코드 예제에서는 메서드를 사용 하 여 사전에서 키/값 쌍을 제거 하는 방법을 보여 줍니다 Remove .The following code example shows how to remove a key/value pair from a dictionary using the Remove method.

이 코드 예제는 클래스에 대해 제공 된 더 큰 예제의 일부입니다 Dictionary<TKey,TValue> openWith .는이 예제에서 사용 되는 사전의 이름입니다.This code example is part of a larger example provided for the Dictionary<TKey,TValue> class (openWith is the name of the Dictionary used in this example).

// 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> 변경 되지 않은 상태로 유지 됩니다.If the Dictionary<TKey,TValue> does not contain an element with the specified key, the Dictionary<TKey,TValue> remains unchanged. 예외가 throw되지 않습니다.No exception is thrown.

이 메서드는 O (1) 작업에 접근 합니다.This method approaches an O(1) operation.

.NET Core 3.0 +만 해당:이 변경 방법은 인스턴스에서 활성 열거자를 무효화 하지 않고 안전 하 게 호출할 수 있습니다 Dictionary<TKey,TValue> ..NET Core 3.0+ only: this mutating method may be safely called without invalidating active enumerators on the Dictionary<TKey,TValue> instance. 이는 스레드로부터의 안전성을 의미 하지 않습니다.This does not imply thread safety.

추가 정보

적용 대상

Remove(TKey, TValue)

Dictionary<TKey,TValue>에서 지정된 키를 갖는 값을 제거하고, value 매개 변수에 요소를 복사합니다.Removes the value with the specified key from the Dictionary<TKey,TValue>, and copies the element to the value parameter.

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

제거할 요소의 키입니다.The key of the element to remove.

value
TValue

제거된 요소입니다.The removed element.

반환

Boolean

요소를 성공적으로 찾아서 제거한 경우 true이고, 그렇지 않으면 false입니다.true if the element is successfully found and removed; otherwise, false.

예외

key이(가) null인 경우.key is null.

적용 대상