BlockingCollection<T>.Take Método

Definição

Namespace:

System.Collections.Concurrent

Assembly:

System.Collections.Concurrent.dll

Remove um item do BlockingCollection<T>.

Sobrecargas

Take()	Remove um item do BlockingCollection<T>.
Take(CancellationToken)	Remove um item do BlockingCollection<T>.

Take()

Origem:

BlockingCollection.cs

Remove um item do BlockingCollection<T>.

public:
 T Take();

public T Take ();

member this.Take : unit -> 'T

Public Function Take () As T

Retornos

T

O item que foi removido da coleção.

Exceções

ObjectDisposedException

O BlockingCollection<T> foi descartado.

InvalidOperationException

A coleção subjacente foi modificada fora dessa BlockingCollection<T> instância ou o BlockingCollection<T> está vazio e foi marcado como completo em relação a adições.

Comentários

Uma chamada para Take pode ser bloqueada até que um item esteja disponível para ser removido.

A ordem na qual um item é removido depende do tipo de coleção usado para criar a instância BlockingCollection<T>. Ao criar um objeto BlockingCollection<T>, você pode especificar o tipo de coleção a ser usado. Por exemplo, seria possível especificar um objeto ConcurrentQueue<T> para o comportamento primeiro a entrar, primeiro a sair (PEPS) ou um objeto ConcurrentStack<T> para último a entrar, primeiro a sair (UEPS). Você pode usar qualquer classe de coleção que implemente a interface IProducerConsumerCollection<T>. O tipo de coleção padrão para BlockingCollection<T> é ConcurrentQueue<T>.

Confira também

• Coleções Thread-Safe
• Visão geral de BlockingCollection

Take(CancellationToken)

Origem:

BlockingCollection.cs

Remove um item do BlockingCollection<T>.

public:
 T Take(System::Threading::CancellationToken cancellationToken);

public T Take (System.Threading.CancellationToken cancellationToken);

member this.Take : System.Threading.CancellationToken -> 'T

Public Function Take (cancellationToken As CancellationToken) As T

Parâmetros

cancellationToken

CancellationToken

Um token que pode ser usado para cancelar a operação "take".

Retornos

T

O item que foi removido da coleção.

Exceções

OperationCanceledException

O CancellationToken está cancelado.

ObjectDisposedException

O BlockingCollection<T> foi descartado.

InvalidOperationException

A coleção subjacente foi modificada fora dessa BlockingCollection<T> instância ou o BlockingCollection<T> está vazio e foi marcado como completo em relação a adições.

Comentários

Uma chamada para Take pode ser bloqueada até que um item esteja disponível para ser removido ou o token seja cancelado.

A ordem na qual um item é removido depende do tipo de coleção usado para criar a instância BlockingCollection<T>. Ao criar um objeto BlockingCollection<T>, você pode especificar o tipo de coleção a ser usado. Por exemplo, seria possível especificar um objeto ConcurrentQueue<T> para o comportamento primeiro a entrar, primeiro a sair (PEPS) ou um objeto ConcurrentStack<T> para último a entrar, primeiro a sair (UEPS). Você pode usar qualquer classe de coleção que implemente a interface IProducerConsumerCollection<T>. O tipo de coleção padrão para BlockingCollection<T> é ConcurrentQueue<T>.

Confira também

• Coleções Thread-Safe
• Visão geral de BlockingCollection