ConcurrentStack<T>.PushRange Método

Definição

Namespace:
System.Collections.Concurrent
Assemblies:
mscorlib.dll, System.Collections.Concurrent.dll
Assembly:
mscorlib.dll
Assembly:
System.Collections.Concurrent.dll
Assembly:
netstandard.dll

Sobrecargas

Nome Description
PushRange(T[])

Insere vários objetos na parte superior do ConcurrentStack<T> atomicamente.
PushRange(T[], Int32, Int32)

Insere vários objetos na parte superior do ConcurrentStack<T> atomicamente.

PushRange(T[])

Insere vários objetos na parte superior do ConcurrentStack<T> atomicamente.

public:
 void PushRange(cli::array <T> ^ items);
public void PushRange(T[] items);
member this.PushRange : 'T[] -> unit
Public Sub PushRange (items As T())

Parâmetros

items
T[]

Os objetos a serem enviados por push para o ConcurrentStack<T>.

Exceções

ArgumentNullException

items é uma referência nula (Nothing in Visual Basic).

Comentários

Ao adicionar vários itens à pilha, usar o PushRange é um mecanismo mais eficiente do que usar Push um item por vez. Além disso, o PushRange garante que todos os elementos serão adicionados atomicamente, o que significa que nenhum outro thread será capaz de injetar elementos entre os elementos que estão sendo enviados por push. Os itens em índices inferiores na items matriz serão enviados por push antes de itens em índices mais altos.

Para obter um exemplo de código, consulte ConcurrentStack<T>.

Confira também

Aplica-se a

PushRange(T[], Int32, Int32)

Insere vários objetos na parte superior do ConcurrentStack<T> atomicamente.

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)

Parâmetros

items
T[]

Os objetos a serem enviados por push para o ConcurrentStack<T>.

startIndex
Int32

O deslocamento baseado em zero no items qual começar a inserir elementos na parte superior do ConcurrentStack<T>.

count
Int32

O número de elementos a serem inseridos na parte superior do ConcurrentStack<T>.

Exceções

ArgumentNullException

items é uma referência nula (Nothing in Visual Basic).

ArgumentOutOfRangeException

startIndex ou count é negativo. Ou startIndex é maior ou igual ao tamanho de items.

ArgumentException

startIndex + count é maior que o comprimento de items.

Comentários

Ao adicionar vários itens à pilha, usar o PushRange é um mecanismo mais eficiente do que usar Push um item por vez. Além disso, o PushRange garante que todos os elementos serão adicionados atomicamente, o que significa que nenhum outro thread será capaz de injetar elementos entre os elementos que estão sendo enviados por push. Os itens em índices inferiores na items matriz serão enviados por push antes de itens em índices mais altos.

Para obter um exemplo de código, consulte ConcurrentStack<T>.

Confira também

Aplica-se a