ConcurrentStack<T>.PushRange 方法

定义

命名空间:

System.Collections.Concurrent

程序集:

System.Collections.Concurrent.dll

重载

PushRange(T[])	自动将多个对象插入 ConcurrentStack<T> 的顶部。
PushRange(T[], Int32, Int32)	自动将多个对象插入 ConcurrentStack<T> 的顶部。

PushRange(T[])

Source:

ConcurrentStack.cs

自动将多个对象插入 ConcurrentStack<T> 的顶部。

public:
 void PushRange(cli::array <T> ^ items);

public void PushRange (T[] items);

member this.PushRange : 'T[] -> unit

Public Sub PushRange (items As T())

参数

items

T[]

要推入到 ConcurrentStack<T> 中的对象。

例外

ArgumentNullException

items 为 null 引用（在 Visual Basic 中为 Nothing）。

注解

将多个项添加到堆栈时，使用 PushRange 比一次使用 Push 一个项更高效。 此外，PushRange 保证所有元素都将以原子方式添加，这意味着其他线程将无法在所推送的元素之间注入元素。 数组中 items 索引较低的项将推送到索引较高的项之前。

有关代码示例，请参阅 ConcurrentStack<T>。

另请参阅

• 线程安全集合

PushRange(T[], Int32, Int32)

Source:

ConcurrentStack.cs

自动将多个对象插入 ConcurrentStack<T> 的顶部。

public:
 void PushRange(cli::array <T> ^ items, int startIndex, int count);

public void PushRange (T[] items, int startIndex, int count);

member this.PushRange : 'T[] * int * int -> unit

Public Sub PushRange (items As T(), startIndex As Integer, count As Integer)

参数

items

T[]

要推入到 ConcurrentStack<T> 中的对象。

startIndex

Int32

items 中从零开始的偏移量，在此开始将元素插入到 ConcurrentStack<T> 的顶部。

count

Int32

要插入到 ConcurrentStack<T> 顶部的元素数。

例外

ArgumentNullException

items 为 null 引用（在 Visual Basic 中为 Nothing）。

ArgumentOutOfRangeException

startIndex 或 count 为负数。 或 startIndex 大于或等于 items 的长度。

ArgumentException

startIndex + count 大于 items 的长度。

注解

将多个项添加到堆栈时，使用 PushRange 比一次使用 Push 一个项更高效。 此外，PushRange 保证所有元素都将以原子方式添加，这意味着其他线程将无法在所推送的元素之间注入元素。 数组中 items 索引较低的项将推送到索引较高的项之前。

有关代码示例，请参阅 ConcurrentStack<T>。

另请参阅

• 线程安全集合