ConcurrentStack<T>.PushRange Método

Definição

Sobrecargas

PushRange(T[])

Insere vários objetos na parte superior do ConcurrentStack<T> de maneira atômica.Inserts multiple objects at the top of the ConcurrentStack<T> atomically.

PushRange(T[], Int32, Int32)

Insere vários objetos na parte superior do ConcurrentStack<T> de maneira atômica.Inserts multiple objects at the top of the ConcurrentStack<T> atomically.

PushRange(T[])

Insere vários objetos na parte superior do ConcurrentStack<T> de maneira atômica.Inserts multiple objects at the top of the ConcurrentStack<T> atomically.

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>.The objects to push onto the ConcurrentStack<T>.

Exceções

items é uma referência nula (Nada no Visual Basic).items is a null reference (Nothing in Visual Basic).

Comentários

Ao adicionar vários itens à pilha, usar PushRange é um mecanismo mais eficiente do que usar Push um item por vez.When adding multiple items to the stack, using PushRange is a more efficient mechanism than using Push one item at a time. 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.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. Os itens em índices inferiores na matriz de items serão enviados antes dos itens em índices mais altos.Items at lower indices in the items array will be pushed before items at higher indices.

Para obter um exemplo de código, consulte ConcurrentStack<T>.For a code example, see ConcurrentStack<T>.

Veja também

PushRange(T[], Int32, Int32)

Insere vários objetos na parte superior do ConcurrentStack<T> de maneira atômica.Inserts multiple objects at the top of the ConcurrentStack<T> atomically.

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>.The objects to push onto the ConcurrentStack<T>.

startIndex
Int32

O deslocamento de base zero em items no qual começar a inserir elementos na parte superior do ConcurrentStack<T>.The zero-based offset in items at which to begin inserting elements onto the top of the ConcurrentStack<T>.

count
Int32

O número de elementos a serem inseridos na parte superior do ConcurrentStack<T>.The number of elements to be inserted onto the top of the ConcurrentStack<T>.

Exceções

items é uma referência nula (Nada no Visual Basic).items is a null reference (Nothing in Visual Basic).

startIndex ou count é negativo.startIndex or count is negative. Ou startIndex é maior que ou igual ao comprimento da items.Or startIndex is greater than or equal to the length of items.

startIndex + count é maior que o comprimento do items.startIndex + count is greater than the length of items.

Comentários

Ao adicionar vários itens à pilha, usar PushRange é um mecanismo mais eficiente do que usar Push um item por vez.When adding multiple items to the stack, using PushRange is a more efficient mechanism than using Push one item at a time. 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.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. Os itens em índices inferiores na matriz de items serão enviados antes dos itens em índices mais altos.Items at lower indices in the items array will be pushed before items at higher indices.

Para obter um exemplo de código, consulte ConcurrentStack<T>.For a code example, see ConcurrentStack<T>.

Veja também

Aplica-se a