Dictionary(Of TKey, TValue).IDictionary.Remove Method (Object)
.NET Framework (current version)
Removes the element with the specified key from the IDictionary.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- key
-
Type:
System.Object
The key of the element to remove.
Implements
IDictionary.Remove(Object)| Exception | Condition |
|---|---|
| ArgumentNullException | key is null. |
This method approaches an O(1) operation.
The following code example shows how to use the IDictionary.Remove of the System.Collections.IDictionary interface with a Dictionary(Of TKey, TValue).
The code example is part of a larger example, including output, provided for the IDictionary.Add method.
Imports System Imports System.Collections Imports System.Collections.Generic Public Class Example Public Shared Sub Main() ' Create a new dictionary of strings, with string keys, ' and access it using the IDictionary interface. ' Dim openWith As IDictionary = _ New Dictionary(Of String, String) ' Add some elements to the dictionary. There are no ' duplicate keys, but some of the values are duplicates. ' IDictionary.Add throws an exception if incorrect types ' are supplied for key or value. openWith.Add("txt", "notepad.exe") openWith.Add("bmp", "paint.exe") openWith.Add("dib", "paint.exe") openWith.Add("rtf", "wordpad.exe")
' Use the Remove method to remove a key/value pair. No ' exception is thrown if the wrong data type is supplied. Console.WriteLine(vbLf + "Remove(""dib"")") openWith.Remove("dib") If Not openWith.Contains("dib") Then Console.WriteLine("Key ""dib"" is not found.") End If
Universal Windows Platform
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Show: