BlockingCollection<T>.Take Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Remove um item do BlockingCollection<T>.
Sobrecargas
| Name | Description |
|---|---|
| Take() |
Remove um item do BlockingCollection<T>. |
| Take(CancellationToken) |
Remove um item do BlockingCollection<T>. |
Take()
Remove um item do BlockingCollection<T>.
public:
T Take();public T Take();member this.Take : unit -> 'TPublic Function Take () As TDevoluções
O item que foi removido da coleção.
Exceções
O BlockingCollection<T> foi descartado.
A coleção subjacente foi modificada fora desta BlockingCollection<T> instância, ou então está BlockingCollection<T> vazia e foi marcada como completa no que diz respeito às adições.
Observações
Uma chamada para Take pode bloquear até que um item esteja disponível para ser removido.
A ordem em que um item é removido depende do tipo de coleção usada para criar a BlockingCollection<T> instância. Quando crias um BlockingCollection<T> objeto, podes especificar o tipo de coleção a usar. Por exemplo, pode especificar um ConcurrentQueue<T> objeto para comportamento de primeiro a entrar, primeiro a sair (FIFO), ou um ConcurrentStack<T> objeto para o comportamento de último a entrar, primeiro a sair (LIFO). Você pode usar qualquer classe de coleção que implemente a IProducerConsumerCollection<T> interface. O tipo de coleção padrão para BlockingCollection<T> é ConcurrentQueue<T>.
Ver também
Aplica-se a
Take(CancellationToken)
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 -> 'TPublic Function Take (cancellationToken As CancellationToken) As TParâmetros
- cancellationToken
- CancellationToken
Um token que pode ser usado para cancelar a operação de "take".
Devoluções
O item que foi removido da coleção.
Exceções
Está CancellationToken cancelado.
O BlockingCollection<T> foi descartado.
A coleção subjacente foi modificada fora desta BlockingCollection<T> instância, ou então está BlockingCollection<T> vazia e foi marcada como completa no que diz respeito às adições.
Observações
Uma chamada pode Take bloquear até que um item esteja disponível para ser removido ou o token seja cancelado.
A ordem em que um item é removido depende do tipo de coleção usada para criar a BlockingCollection<T> instância. Quando crias um BlockingCollection<T> objeto, podes especificar o tipo de coleção a usar. Por exemplo, pode especificar um ConcurrentQueue<T> objeto para comportamento de primeiro a entrar, primeiro a sair (FIFO), ou um ConcurrentStack<T> objeto para o comportamento de último a entrar, primeiro a sair (LIFO). Você pode usar qualquer classe de coleção que implemente a IProducerConsumerCollection<T> interface. O tipo de coleção padrão para BlockingCollection<T> é ConcurrentQueue<T>.