Collection.IList.Remove(Object) Method

Definition

Removes the first occurrence of a specific object from the Collection object.

 virtual void IListRemove(System::Object ^ value) = System::Collections::IList::Remove;
void IList.Remove (object value);
abstract member IListRemove : obj -> unit
override this.IListRemove : obj -> unit
Sub IListRemove (value As Object) Implements IList.Remove

Parameters

value
Object

The Object to remove from the Collection object.

Exceptions

The Collection object is read-only.

-or-

The Collection object has a fixed size.

Remarks

In collections of contiguous elements, such as lists, the elements that follow the removed element move up to occupy the vacated spot. If the collection is indexed, the indexes of the elements that are moved are also updated. This behavior does not apply to collections where elements are conceptually grouped into buckets, such as a hash table. If value is not found in the Collection object, the Collection object remains unchanged and no exception is thrown.

Applies to

See also