This documentation is archived and is not being maintained.

ConcurrentStack<T>.PushRange Method (T[])

Inserts multiple objects at the top of the ConcurrentStack<T> atomically.

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

public void PushRange(
	T[] items
)

Parameters

items
Type: T[]
The objects to push onto the ConcurrentStack<T>.

ExceptionCondition
ArgumentNullException

items is a null reference (Nothing in Visual Basic).

When adding multiple items to the stack, using PushRange is a more efficient mechanism than using Push one item at a time. Additionally, PushRange guarantees that all of the elements will be added atomically, meaning that no other threads will be able to inject elements between the elements being pushed. Items at lower indices in the items array will be pushed before items at higher indices.

For a code example, see ConcurrentStack<T>.

.NET Framework

Supported in: 4

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: