Windows apps
Collapse the table of content
Expand the table of content

Remove Method

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

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

Namespace:  System.Collections
Assembly:  mscorlib (in mscorlib.dll)

void Remove(
	Object value
)

Parameters

value
Type: System..::..Object
The object to remove from the IList.

ExceptionCondition
NotSupportedException

The IList is read-only.

-or-

The IList has a fixed size.

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 IList, the IList remains unchanged and no exception is thrown.

Notes to Implementers

If value is not in the list, the Remove method should do nothing. In particular, it should not throw an exception.

Show:
© 2017 Microsoft