ConcurrentStack<T>.TryPopRange Método

Definição

Namespace:

System.Collections.Concurrent

Assembly:

System.Collections.Concurrent.dll

Sobrecargas

TryPopRange(T[], Int32, Int32)	Tenta remover e retornar vários objetos da parte superior do ConcurrentStack<T> de forma atômica.
TryPopRange(T[])	Tenta remover e retornar vários objetos da parte superior do ConcurrentStack<T> de forma atômica.

TryPopRange(T[], Int32, Int32)

Origem:

ConcurrentStack.cs

Tenta remover e retornar vários objetos da parte superior do ConcurrentStack<T> de forma atômica.

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

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

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

Public Function TryPopRange (items As T(), startIndex As Integer, count As Integer) As Integer

Parâmetros

items

T[]

O Array a que os objetos removidos da parte superior de ConcurrentStack<T> serão adicionados.

startIndex

Int32

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

count

Int32

O número de elementos a serem removidos da parte superior do ConcurrentStack<T> e inseridos em items.

Retornos

Int32

O número de objetos removidos com êxito da parte superior da pilha e inseridos no items.

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 exibir vários itens, se houver pouca contenção na pilha, o uso de TryPopRange poderá ser mais eficiente do que usar TryPop uma vez por item a ser removido. Os nós preenchem a items matriz com o primeiro item a ser exibido no startIndex, o segundo item a ser exibido em startIndex + 1 e assim por diante.

Confira também

• Coleções Thread-Safe

TryPopRange(T[])

Origem:

ConcurrentStack.cs

Tenta remover e retornar vários objetos da parte superior do ConcurrentStack<T> de forma atômica.

public:
 int TryPopRange(cli::array <T> ^ items);

public int TryPopRange (T[] items);

member this.TryPopRange : 'T[] -> int

Public Function TryPopRange (items As T()) As Integer

Parâmetros

items

T[]

O Array a que os objetos removidos da parte superior de ConcurrentStack<T> serão adicionados.

Retornos

Int32

O número de objetos removidos com êxito da parte superior do ConcurrentStack<T> e inseridos no items.

Exceções

ArgumentNullException

items é um argumento nulo (Nada no Visual Basic).

Comentários

Ao exibir vários itens, se houver pouca contenção na pilha, usar TryPopRange pode ser mais eficiente do que usar TryPop uma vez por item a ser removido. Os nós preenchem a items matriz com o primeiro item a ser exibido no startIndex, o segundo item a ser exibido em startIndex + 1 e assim por diante.

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

Confira também

• Coleções Thread-Safe