BlockingCollection<T>.Take Metoda

Definice

Obor názvů:

System.Collections.Concurrent

Sestavení:

System.Collections.Concurrent.dll

Odebere položku z objektu BlockingCollection<T>.

Přetížení

Take()	Odebere položku z objektu BlockingCollection<T>.
Take(CancellationToken)	Odebere položku z objektu BlockingCollection<T>.

Take()

Zdroj:

BlockingCollection.cs

Odebere položku z objektu BlockingCollection<T>.

public:
 T Take();

public T Take ();

member this.Take : unit -> 'T

Public Function Take () As T

Návraty

T

Položka, která byla odebrána z kolekce.

Výjimky

ObjectDisposedException

Byla BlockingCollection<T> zlikvidována.

InvalidOperationException

Podkladová kolekce byla změněna mimo tuto BlockingCollection<T> instanci nebo BlockingCollection<T> je prázdná a byla označena jako úplná s ohledem na sčítání.

Poznámky

Volání může blokovat, Take dokud nebude k dispozici položka k odebrání.

Pořadí, ve kterém je položka odebrána, závisí na typu kolekce použité k vytvoření BlockingCollection<T> instance. Při vytváření objektu BlockingCollection<T> můžete určit typ kolekce, která se má použít. Můžete například zadat ConcurrentQueue<T> objekt pro chování FIFO (first in, first out) nebo ConcurrentStack<T> objekt pro chování lifo (last in, first out). Můžete použít libovolnou třídu kolekce, která implementuje IProducerConsumerCollection<T> rozhraní . Výchozí typ kolekce pro BlockingCollection<T> je ConcurrentQueue<T>.

Viz také

• Kolekce bezpečné pro přístup z více vláken
• BlockingCollection – přehled

Take(CancellationToken)

Zdroj:

BlockingCollection.cs

Odebere položku z objektu 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

Parametry

cancellationToken

CancellationToken

Token, který lze použít ke zrušení operace "take".

Návraty

T

Položka, která byla odebrána z kolekce.

Výjimky

OperationCanceledException

Položka CancellationToken je zrušena.

ObjectDisposedException

Byla BlockingCollection<T> zlikvidována.

InvalidOperationException

Podkladová kolekce byla změněna mimo tuto BlockingCollection<T> instanci nebo BlockingCollection<T> je prázdná a byla označena jako úplná s ohledem na sčítání.

Poznámky

Volání metody může být blokováno Take , dokud není k dispozici položka, která se dá odebrat, nebo dokud se token nezruší.

Pořadí, ve kterém je položka odebrána, závisí na typu kolekce použité k vytvoření BlockingCollection<T> instance. Při vytváření objektu BlockingCollection<T> můžete určit typ kolekce, která se má použít. Můžete například zadat ConcurrentQueue<T> objekt pro chování FIFO (first in, first out) nebo ConcurrentStack<T> objekt pro chování lifo (last in, first out). Můžete použít libovolnou třídu kolekce, která implementuje IProducerConsumerCollection<T> rozhraní . Výchozí typ kolekce pro BlockingCollection<T> je ConcurrentQueue<T>.

Viz také

• Kolekce bezpečné pro přístup z více vláken
• BlockingCollection – přehled