PropertyCollection.IDictionary.Remove(Object) 方法
定义
从 IDictionary 对象中移除具有指定键的元素。Removes the element with the specified key from the IDictionary object.
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
参数
- key
- Object
要移除的元素的键。The key of the element to remove.
实现
例外
key 为 null。key is null.
IDictionary 对象是只读的。The IDictionary object is read-only.
- 或 --or- IDictionary 具有固定的大小。The IDictionary has a fixed size.
示例
下面的示例演示如何实现 Remove 方法。The following example shows how to implement the Remove method. 此代码示例是为类提供的更大示例的一部分 IDictionary 。This code example is part of a larger example provided for the IDictionary class.
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