BlockingCollection<T>.Take Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- Origem:
- BlockingCollection.cs
- 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
O item que foi removido da coleção.
Exceções
O BlockingCollection<T> foi descartado.
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
Aplica-se a
Take(CancellationToken)
- Origem:
- BlockingCollection.cs
- Origem:
- BlockingCollection.cs
- 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
O item que foi removido da coleção.
Exceções
O CancellationToken está cancelado.
O BlockingCollection<T> foi descartado.
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>.