PropertyCollection.IDictionary.Remove(Object) Methode

Definition

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

Quelle:

PropertyCollection.cs

Entfernt das Element mit dem angegebenen Schlüssel aus dem IDictionary-Objekt.

 virtual void System.Collections.IDictionary.Remove(System::Object ^ key) = System::Collections::IDictionary::Remove;

void IDictionary.Remove (object key);

abstract member System.Collections.IDictionary.Remove : obj -> unit
override this.System.Collections.IDictionary.Remove : obj -> unit

Sub Remove (key As Object) Implements IDictionary.Remove

Parameter

key

Object

Der Schlüssel des zu entfernenden Elements.

Implementiert

Remove(Object)

Ausnahmen

ArgumentNullException

key ist null.

NotSupportedException

Das IDictionary-Objekt ist schreibgeschützt.

- oder -

IDictionary hat eine feste Größe.

Beispiele

Im folgenden Beispiel wird die Implementierung der Remove-Methode veranschaulicht. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die IDictionary-Klasse bereitgestellt wird.

public:
    virtual void Remove(Object^ key)
    {
        if (key == nullptr)
        {
            throw gcnew ArgumentNullException("key");
        }
        // Try to find the key in the DictionaryEntry array
        int index;
        if (TryGetIndexOfKey(key, &index))
        {
            // If the key is found, slide all the items down.
            Array::Copy(items, index + 1, items, index, itemsInUse -
                index - 1);
            itemsInUse--;
        }
        else
        {
            // If the key is not in the dictionary, just return.
            return;
        }
    }

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