ConcurrentStack<T>.PushRange Método

Definição

Namespace:

System.Collections.Concurrent

Assembly:

System.Collections.Concurrent.dll

Sobrecargas

PushRange(T[])	Insere vários objetos na parte superior do ConcurrentStack<T> de maneira atômica.
PushRange(T[], Int32, Int32)	Insere vários objetos na parte superior do ConcurrentStack<T> de maneira atômica.

PushRange(T[])

Origem:

ConcurrentStack.cs

Insere vários objetos na parte superior do ConcurrentStack<T> de maneira atômica.

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 (Nada no Visual Basic).

Comentários

Ao adicionar vários itens à pilha, usar PushRange é um mecanismo mais eficiente do que usar Push um item de cada vez. Além disso, 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

• Coleções Thread-Safe

PushRange(T[], Int32, Int32)

Origem:

ConcurrentStack.cs

Insere vários objetos na parte superior do ConcurrentStack<T> de maneira atômica.

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 de base zero em items no 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 (Nada no Visual Basic).

ArgumentOutOfRangeException

startIndex ou count é negativo. Ou startIndex é maior que ou igual ao comprimento da items.

ArgumentException

startIndex + count é maior que o comprimento do items.

Comentários

Ao adicionar vários itens à pilha, usar PushRange é um mecanismo mais eficiente do que usar Push um item de cada vez. Além disso, 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

• Coleções Thread-Safe