Remove Method

Removes the entry with the specified key from the ListDictionary.

[Visual Basic]
Public Overridable Sub Remove( _
   ByVal key As Object _
) Implements IDictionary.Remove
[C#]
public virtual void Remove(
   object key
);
[C++]
public: virtual void Remove(
   Object* key
);
[JScript]
public function Remove(
   key : Object
);

Parameters

key: The key of the entry to remove.

Implements

IDictionary.Remove

Exceptions

Exception Type	Condition
ArgumentNullException	key is a null reference (Nothing in Visual Basic).

Remarks

If the ListDictionary does not contain an element with the specified key, the ListDictionary remains unchanged. No exception is thrown.

This is an O(n) operation, where n is Count.

Example

[Visual Basic] 
' The following code example adds to and removes elements from a ListDictionary.

Imports System
Imports System.Collections
Imports System.Collections.Specialized

Public Class SamplesListDictionary   

   Public Shared Sub Main()

      ' Creates and initializes a new ListDictionary.
      Dim myCol As New ListDictionary()
      myCol.Add("Braeburn Apples", "1.49")
      myCol.Add("Fuji Apples", "1.29")
      myCol.Add("Gala Apples", "1.49")
      myCol.Add("Golden Delicious Apples", "1.29")
      myCol.Add("Granny Smith Apples", "0.89")
      myCol.Add("Red Delicious Apples", "0.99")

      ' Displays the values in the ListDictionary in three different ways.
      Console.WriteLine("Initial contents of the ListDictionary:")
      PrintKeysAndValues(myCol)

      ' Deletes a key.
      myCol.Remove("Plums")
      Console.WriteLine("The collection contains the following elements after removing ""Plums"":")
      PrintKeysAndValues(myCol)

      ' Clears the entire collection.
      myCol.Clear()
      Console.WriteLine("The collection contains the following elements after it is cleared:")
      PrintKeysAndValues(myCol)

   End Sub 'Main

   Public Shared Sub PrintKeysAndValues(myCol As IEnumerable)
      Dim myEnumerator As IEnumerator = myCol.GetEnumerator()

      Console.WriteLine("   KEY                       VALUE")
      Dim de As DictionaryEntry
      For Each de In  myCol
         Console.WriteLine("   {0,-25} {1}", de.Key, de.Value)
      Next de
      Console.WriteLine()

   End Sub 'PrintKeysAndValues

End Class 'SamplesListDictionary 


'This code produces the following output.
'
'Initial contents of the ListDictionary:
'   KEY                       VALUE
'   Braeburn Apples           1.49
'   Fuji Apples               1.29
'   Gala Apples               1.49
'   Golden Delicious Apples   1.29
'   Granny Smith Apples       0.89
'   Red Delicious Apples      0.99
'
'The collection contains the following elements after removing "Plums":
'   KEY                       VALUE
'   Braeburn Apples           1.49
'   Fuji Apples               1.29
'   Gala Apples               1.49
'   Golden Delicious Apples   1.29
'   Granny Smith Apples       0.89
'   Red Delicious Apples      0.99
'
'The collection contains the following elements after it is cleared:
'   KEY                       VALUE
'


[C#] 
// The following code example adds to and removes elements from a ListDictionary.

using System;
using System.Collections;
using System.Collections.Specialized;

public class SamplesListDictionary  {

   public static void Main()  {

      // Creates and initializes a new ListDictionary.
      ListDictionary myCol = new ListDictionary();
      myCol.Add( "Braeburn Apples", "1.49" );
      myCol.Add( "Fuji Apples", "1.29" );
      myCol.Add( "Gala Apples", "1.49" );
      myCol.Add( "Golden Delicious Apples", "1.29" );
      myCol.Add( "Granny Smith Apples", "0.89" );
      myCol.Add( "Red Delicious Apples", "0.99" );

      // Displays the values in the ListDictionary in three different ways.
      Console.WriteLine( "Initial contents of the ListDictionary:" );
      PrintKeysAndValues( myCol );

      // Deletes a key.
      myCol.Remove( "Plums" );
      Console.WriteLine( "The collection contains the following elements after removing \"Plums\":" );
      PrintKeysAndValues( myCol );

      // Clears the entire collection.
      myCol.Clear();
      Console.WriteLine( "The collection contains the following elements after it is cleared:" );
      PrintKeysAndValues( myCol );

   }

   public static void PrintKeysAndValues( IEnumerable myCol )  {
      IEnumerator myEnumerator = myCol.GetEnumerator();
      Console.WriteLine( "   KEY                       VALUE" );
      foreach ( DictionaryEntry de in myCol )
         Console.WriteLine( "   {0,-25} {1}", de.Key, de.Value );
      Console.WriteLine();
   }

}


/*
This code produces the following output.

Initial contents of the ListDictionary:
   KEY                       VALUE
   Braeburn Apples           1.49
   Fuji Apples               1.29
   Gala Apples               1.49
   Golden Delicious Apples   1.29
   Granny Smith Apples       0.89
   Red Delicious Apples      0.99

The collection contains the following elements after removing "Plums":
   KEY                       VALUE
   Braeburn Apples           1.49
   Fuji Apples               1.29
   Gala Apples               1.49
   Golden Delicious Apples   1.29
   Granny Smith Apples       0.89
   Red Delicious Apples      0.99

The collection contains the following elements after it is cleared:
   KEY                       VALUE

*/


[C++] 
// The following code example adds to and removes elements from a ListDictionary.

#using <mscorlib.dll>
#using <System.dll>

using namespace System;
using namespace System::Collections;
using namespace System::Collections::Specialized;

void PrintKeysAndValues(IEnumerable* myCol) {
   Console::WriteLine(S"   KEY                       VALUE");
   IEnumerator* myEnum = myCol->GetEnumerator();
   while (myEnum->MoveNext()) {
      DictionaryEntry* de = __try_cast<DictionaryEntry*>(myEnum->Current);
      Console::WriteLine(S"   {0, -25} {1}", de->Key, de->Value);
   }      Console::WriteLine();
}

int main() {

   // Creates and initializes a new ListDictionary.
   ListDictionary* myCol = new ListDictionary();
   myCol->Add(S"Braeburn Apples", S"1.49");
   myCol->Add(S"Fuji Apples", S"1.29");
   myCol->Add(S"Gala Apples", S"1.49");
   myCol->Add(S"Golden Delicious Apples", S"1.29");
   myCol->Add(S"Granny Smith Apples", S"0.89");
   myCol->Add(S"Red Delicious Apples", S"0.99");

   // Displays the values in the ListDictionary in three different ways.
   Console::WriteLine(S"Initial contents of the ListDictionary:");
   PrintKeysAndValues(myCol);

   // Deletes a key.
   myCol->Remove(S"Plums");
   Console::WriteLine(S"The collection contains the following elements after removing \"Plums\":");
   PrintKeysAndValues(myCol);

   // Clears the entire collection.
   myCol->Clear();
   Console::WriteLine(S"The collection contains the following elements after it is cleared:");
   PrintKeysAndValues(myCol);
}

/*
This code produces the following output.

Initial contents of the ListDictionary:
KEY                       VALUE
Braeburn Apples           1.49
Fuji Apples               1.29
Gala Apples               1.49
Golden Delicious Apples   1.29
Granny Smith Apples       0.89
Red Delicious Apples      0.99

The collection contains the following elements after removing S"Plums":
KEY                       VALUE
Braeburn Apples           1.49
Fuji Apples               1.29
Gala Apples               1.49
Golden Delicious Apples   1.29
Granny Smith Apples       0.89
Red Delicious Apples      0.99

The collection contains the following elements after it is cleared:
KEY                       VALUE

*/

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework - Windows CE .NET