Remove()

instance.Remove(obj)

Remove(obj)

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

Parameters

obj

The object to remove from the MfCollectionBase.

Throws

Throws MfNullReferenceException if called as a static method.
Throws MfArgumentException if the obj parameter was not found in the MfCollectionBase
Throws MfNotSupportedException if MfCollectionBase is read-only or Fixed size

Remarks

If the MfCollectionBase does not contain the specified object, the MfCollectionBase remains unchanged.

This method is an O(n) operation, where n is Count.

This method determines equality by calling MfObject.CompareTo().

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.

Notes to Implementers

This method calls OnValidate(), OnInsert(), and OnInsertComplete().