CollectionBase.IList.Add Method (Object)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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.

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

Universal Windows Platform
Available since 10
.NET Framework
Available since 1.1
Return to top
Show: