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)

Syntax

'Declaration
Sub Remove ( _
    value As Object _
)

void Remove(
    Object value
)

void Remove(
    Object^ value
)

abstract Remove : 
        value:Object -> unit 

function Remove(
    value : Object
)

Parameters

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

Exceptions

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 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.

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see dd66cd4c-b087-415f-9c3e-94e3a1835f74.

See Also

Reference

IList Interface

System.Collections Namespace