BlockingCollection<T>.Take Metoda

Definicja

Przestrzeń nazw:

System.Collections.Concurrent

Zestaw:

System.Collections.Concurrent.dll

Usuwa element z elementu BlockingCollection<T>.

Przeciążenia

Take()	Usuwa element z elementu BlockingCollection<T>.
Take(CancellationToken)	Usuwa element z elementu BlockingCollection<T>.

Take()

Źródło:

BlockingCollection.cs

Usuwa element z elementu BlockingCollection<T>.

public:
 T Take();

public T Take ();

member this.Take : unit -> 'T

Public Function Take () As T

Zwraca

T

Element, który został usunięty z kolekcji.

Wyjątki

ObjectDisposedException

Został BlockingCollection<T> usunięty.

InvalidOperationException

Kolekcja bazowa została zmodyfikowana poza tym BlockingCollection<T> wystąpieniem lub BlockingCollection<T> jest pusta i została oznaczona jako kompletna w odniesieniu do dodatków.

Uwagi

Wywołanie metody może Take zablokować, dopóki element nie zostanie usunięty.

Kolejność usuwania elementu zależy od typu kolekcji używanej do utworzenia BlockingCollection<T> wystąpienia. Podczas tworzenia BlockingCollection<T> obiektu można określić typ kolekcji do użycia. Można na przykład określić ConcurrentQueue<T> obiekt dla pierwszego w, pierwszy na wyjścia (FIFO) zachowanie lub obiekt dla ostatniego ConcurrentStack<T> w, najpierw na wyjścia (LIFO). Można użyć dowolnej klasy kolekcji, która implementuje IProducerConsumerCollection<T> interfejs. Domyślnym typem kolekcji parametru BlockingCollection<T> jest ConcurrentQueue<T>.

Zobacz też

• Kolekcje bezpieczne wątkowo
• BlockingCollection — Przegląd

Take(CancellationToken)

Źródło:

BlockingCollection.cs

Usuwa element z elementu 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, którego można użyć do anulowania operacji "take".

Zwraca

T

Element, który został usunięty z kolekcji.

Wyjątki

OperationCanceledException

Element CancellationToken zostanie anulowany.

ObjectDisposedException

Został BlockingCollection<T> usunięty.

InvalidOperationException

Kolekcja bazowa została zmodyfikowana poza tym BlockingCollection<T> wystąpieniem lub BlockingCollection<T> jest pusta i została oznaczona jako kompletna w odniesieniu do dodatków.

Uwagi

Wywołanie metody może Take zablokować, dopóki element nie zostanie usunięty lub token zostanie anulowany.

Kolejność usuwania elementu zależy od typu kolekcji używanej do utworzenia BlockingCollection<T> wystąpienia. Podczas tworzenia BlockingCollection<T> obiektu można określić typ kolekcji do użycia. Można na przykład określić ConcurrentQueue<T> obiekt dla pierwszego w, pierwszy na wyjścia (FIFO) zachowanie lub obiekt dla ostatniego ConcurrentStack<T> w, najpierw na wyjścia (LIFO). Można użyć dowolnej klasy kolekcji, która implementuje IProducerConsumerCollection<T> interfejs. Domyślnym typem kolekcji parametru BlockingCollection<T> jest ConcurrentQueue<T>.

Zobacz też

• Kolekcje bezpieczne wątkowo
• BlockingCollection — Przegląd