ConcurrentStack<T>.PushRange Метод

Определение

Пространство имен:

System.Collections.Concurrent

Сборка:

System.Collections.Concurrent.dll

Перегрузки

PushRange(T[])	Вставляет неделимым блоком несколько объектов в качестве верхнего элемента ConcurrentStack<T>.
PushRange(T[], Int32, Int32)	Вставляет неделимым блоком несколько объектов в качестве верхнего элемента ConcurrentStack<T>.

PushRange(T[])

Исходный код:

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 (Nothing в Visual Basic).

Комментарии

При добавлении нескольких элементов в стек использование PushRange является более эффективным механизмом, чем использование Push одного элемента за раз. Кроме того, PushRange гарантирует, что все элементы будут добавлены атомарным образом. Это означает, что никакие другие потоки не смогут внедрять элементы между отправляемыми элементами. Элементы с более низкими индексами в массиве items будут отправляться перед элементами с более высокими индексами.

Пример кода см. в разделе ConcurrentStack<T>.

См. также раздел

• Потокобезопасные коллекции

PushRange(T[], Int32, Int32)

Исходный код:

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 (Nothing в Visual Basic).

ArgumentOutOfRangeException

startIndex или count является отрицательным значением. Или значение параметра startIndex больше или равно длине items.

ArgumentException

Значение startIndex + count превышает длину items.

Комментарии

При добавлении нескольких элементов в стек использование PushRange является более эффективным механизмом, чем использование Push одного элемента за раз. Кроме того, PushRange гарантирует, что все элементы будут добавлены атомарным образом. Это означает, что никакие другие потоки не смогут внедрять элементы между отправляемыми элементами. Элементы с более низкими индексами в массиве items будут отправляться перед элементами с более высокими индексами.

Пример кода см. в разделе ConcurrentStack<T>.

См. также раздел

• Потокобезопасные коллекции