Partilhar via


ConcurrentStack<T>.TryPopRange Método

Definição

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
Origem:
ConcurrentStack.cs
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

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

Exceções

items é uma referência nula (Nada no Visual Basic).

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

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

Aplica-se a

TryPopRange(T[])

Origem:
ConcurrentStack.cs
Origem:
ConcurrentStack.cs
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

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

Exceções

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

Aplica-se a