IDictionary.Remove(Object) Yöntem

Tanım

Ad Alanı:

System.Collections

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

IDictionary.cs

Belirtilen anahtara sahip öğesini nesneden IDictionary kaldırır.

public:
 void Remove(System::Object ^ key);

public void Remove(object key);

abstract member Remove : obj -> unit

Public Sub Remove (key As Object)

Parametreler

key

Object

Kaldırılacak öğenin anahtarı.

Özel durumlar

ArgumentNullException

key, null'e eşittir.

NotSupportedException

IDictionary Nesne salt okunurdur.

-veya-

sabit IDictionary bir boyuta sahiptir.

Örnekler

Aşağıdaki kod örneği, yönteminin nasıl uygulanduğunu Remove gösterir. Bu kod örneği, sınıfı için IDictionary sağlanan daha büyük bir örneğin parçasıdır.

public void Remove(object key)
{
    if (key == null) throw new ArgumentNullException("key");
    // Try to find the key in the DictionaryEntry array
    Int32 index;
    if (TryGetIndexOfKey(key, out index))
    {
        // If the key is found, slide all the items up.
        Array.Copy(items, index + 1, items, index, ItemsInUse - index - 1);
        ItemsInUse--;
    }
    else
    {
        // If the key is not in the dictionary, just return.
    }
}

Public Sub Remove(ByVal key As Object) Implements IDictionary.Remove
    If key = Nothing Then
        Throw New ArgumentNullException("key")
    End If
    ' Try to find the key in the DictionaryEntry array
    Dim index As Integer
    If TryGetIndexOfKey(key, index) Then

        ' If the key is found, slide all the items up.
        Array.Copy(items, index + 1, items, index, (ItemsInUse - index) - 1)
        ItemsInUse = ItemsInUse - 1
    Else

        ' If the key is not in the dictionary, just return. 
    End If
End Sub

Açıklamalar

Nesne belirtilen IDictionary anahtara sahip bir öğe içermiyorsa, IDictionary değişmeden kalır. İstisna atılmaz.