BlockingCollection<T>.Take Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Entfernt ein Element aus BlockingCollection<T>.
Überlädt
| Take() |
Entfernt ein Element aus BlockingCollection<T>. |
| Take(CancellationToken) |
Entfernt ein Element aus BlockingCollection<T>. |
Take()
Entfernt ein Element aus BlockingCollection<T>.
public:
T Take();public T Take ();member this.Take : unit -> 'TPublic Function Take () As TGibt zurück
- T
Das Element, das aus der Auflistung entfernt wurde.
Ausnahmen
BlockingCollection<T> wurde verworfen.
Die zugrunde liegende Auflistung wurde außerhalb dieser BlockingCollection<T> Instanz geändert, oder die BlockingCollection<T> ist leer und wurde im Hinblick auf Ergänzungen als vollständig markiert.
Hinweise
Ein Aufruf kann blockieren, Take bis ein Element entfernt werden kann.
Die Reihenfolge, in der ein Element entfernt wird, hängt vom Typ der Auflistung ab, die zum Erstellen der BlockingCollection<T> Instanz 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 zuerst in, first out (FIFO)-Verhalten oder ein ConcurrentStack<T> Objekt für das letzte Verhalten (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>.
Siehe auch
Gilt für:
Take(CancellationToken)
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 -> 'TPublic Function Take (cancellationToken As CancellationToken) As TParameter
- cancellationToken
- CancellationToken
Ein Token, das zum Abbrechen des Vorgangs "Take" verwendet werden kann.
Gibt zurück
- T
Das Element, das aus der Auflistung entfernt wurde.
Ausnahmen
Das CancellationToken wird abgebrochen.
BlockingCollection<T> wurde verworfen.
Die zugrunde liegende Auflistung wurde außerhalb dieser BlockingCollection<T> Instanz geändert, oder die BlockingCollection<T> ist leer und wurde im Hinblick auf Ergänzungen als vollständig markiert.
Hinweise
Ein Aufruf kann blockieren, Take bis ein Element entfernt werden kann, 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> Instanz 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 zuerst in, first out (FIFO)-Verhalten oder ein ConcurrentStack<T> Objekt für das letzte Verhalten (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>.