Export (0) Print
Expand All

CollectionBase.IList.Add Method

Adds an object to the end of the CollectionBase.

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

private abstract Add : 
        value:Object -> int  
private override Add : 
        value:Object -> int

Parameters

value
Type: System.Object

The Object to be added to the end of the CollectionBase.

Return Value

Type: System.Int32
The CollectionBase index at which the value has been added.

Implements

IList.Add(Object)

ExceptionCondition
NotSupportedException

The CollectionBase is read-only.

-or-

The CollectionBase has a fixed size.

If Count already equals the capacity, the capacity of the list is doubled by automatically reallocating the internal array and copying the existing elements to the new array before the new element is added.

If Count is less than the capacity, this method is an O(1) operation. If the capacity needs to be increased to accommodate the new element, this method becomes an O(n) operation, where n is Count.

Notes to Implementers

This method calls OnValidate, OnInsert, and OnInsertComplete.

The following code example implements the CollectionBase class and uses that implementation to create a collection of Int16 objects.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0
Show:
© 2015 Microsoft