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

.NET Framework 4.6 and 4.5

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

Namespace:  System.Collections.Concurrent
Assemblies:   System.Collections.Concurrent (in System.Collections.Concurrent.dll)
  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.6, 4.5, 4

.NET Framework Client Profile

Supported in: 4

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft