BlockingCollection<T>.Take Methode

Definition

Namespace:

System.Collections.Concurrent

Assembly:

System.Collections.Concurrent.dll

Entfernt ein Element aus BlockingCollection<T>.

Überlädt

Take()	Entfernt ein Element aus BlockingCollection<T>.
Take(CancellationToken)	Entfernt ein Element aus BlockingCollection<T>.

Take()

Quelle:

BlockingCollection.cs

Entfernt ein Element aus BlockingCollection<T>.

public:
 T Take();

public T Take ();

member this.Take : unit -> 'T

Public Function Take () As T

Gibt zurück

T

Das Element, das aus der Auflistung entfernt wurde.

Ausnahmen

ObjectDisposedException

BlockingCollection<T> wurde verworfen.

InvalidOperationException

Die zugrunde liegende Auflistung wurde außerhalb dieses BlockingCollection<T> instance geändert, oder die BlockingCollection<T> ist leer und wurde in Bezug auf Ergänzungen als vollständig markiert.

Hinweise

Ein Aufruf von kann blockiert werden, Take bis ein Element zum Entfernen verfügbar ist.

Die Reihenfolge, in der ein Element entfernt wird, hängt vom Typ der Auflistung ab, die zum Erstellen der BlockingCollection<T> instance verwendet wird. Wenn Sie ein BlockingCollection<T> -Objekt erstellen, können Sie den Typ der zu verwendenden Auflistung angeben. Sie können z. B. ein ConcurrentQueue<T> Objekt für das Verhalten first in, first out (FIFO) oder ein ConcurrentStack<T> Objekt für das Verhalten von last in, first out (LIFO) angeben. Sie können jede Sammlungsklasse verwenden, die die IProducerConsumerCollection<T>-Schnittstelle implementiert. Der standardmäßige Sammlungstyp für BlockingCollection<T> ist ConcurrentQueue<T>.

Weitere Informationen

• Threadsichere Sammlungen
• Übersicht über BlockingCollection

Take(CancellationToken)

Quelle:

BlockingCollection.cs

Entfernt ein Element aus 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

Parameter

cancellationToken

CancellationToken

Ein Token, das verwendet werden kann, um den Vorgang "take" abzubrechen.

Gibt zurück

T

Das Element, das aus der Auflistung entfernt wurde.

Ausnahmen

OperationCanceledException

Das CancellationToken wird abgebrochen.

ObjectDisposedException

BlockingCollection<T> wurde verworfen.

InvalidOperationException

Die zugrunde liegende Auflistung wurde außerhalb dieses BlockingCollection<T> instance geändert, oder die BlockingCollection<T> ist leer und wurde in Bezug auf Ergänzungen als vollständig markiert.

Hinweise

Ein Aufruf von kann blockiert werden, Take bis ein Element zum Entfernen verfügbar ist oder das Token abgebrochen wird.

Die Reihenfolge, in der ein Element entfernt wird, hängt vom Typ der Auflistung ab, die zum Erstellen der BlockingCollection<T> instance verwendet wird. Wenn Sie ein BlockingCollection<T> -Objekt erstellen, können Sie den Typ der zu verwendenden Auflistung angeben. Sie können z. B. ein ConcurrentQueue<T> Objekt für das Verhalten first in, first out (FIFO) oder ein ConcurrentStack<T> Objekt für das Verhalten von last in, first out (LIFO) angeben. Sie können jede Sammlungsklasse verwenden, die die IProducerConsumerCollection<T>-Schnittstelle implementiert. Der standardmäßige Sammlungstyp für BlockingCollection<T> ist ConcurrentQueue<T>.

Weitere Informationen

• Threadsichere Sammlungen
• Übersicht über BlockingCollection