Push Method

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

Inserts an object at the top of the Stack.

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

Syntax

'Declaration
Public Overridable Sub Push ( _
    obj As Object _
)

public virtual void Push(
    Object obj
)

public:
virtual void Push(
    Object^ obj
)

abstract Push : 
        obj:Object -> unit 
override Push : 
        obj:Object -> unit 

public function Push(
    obj : Object
)

Parameters

• obj
  Type: System. . :: . .Object
  The Object to push onto the Stack. The value can be nullNothingnullptrunita null reference (Nothing in Visual Basic).

Remarks

Stack is implemented as a circular buffer.

If Count already equals the capacity, the capacity of the Stack is increased by automatically reallocating the internal array, and the existing elements are copied to the new array before the new element is added.

null Nothing nullptr unit a null reference (Nothing in Visual Basic) can be pushed onto the Stack as a placeholder, if needed. It occupies a slot in the stack and is treated like any object.

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

.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

Stack Class

System.Collections Namespace