BlockingCollection<T>.Take Metodo

Definizione

Spazio dei nomi:

System.Collections.Concurrent

Assembly:

System.Collections.Concurrent.dll

Rimuove un elemento da BlockingCollection<T>.

Overload

Take()	Rimuove un elemento da BlockingCollection<T>.
Take(CancellationToken)	Rimuove un elemento da BlockingCollection<T>.

Take()

Source:

BlockingCollection.cs

Rimuove un elemento da BlockingCollection<T>.

public:
 T Take();

public T Take ();

member this.Take : unit -> 'T

Public Function Take () As T

Restituisce

T

Elemento rimosso dalla raccolta.

Eccezioni

ObjectDisposedException

L'interfaccia BlockingCollection<T> è stata eliminata.

InvalidOperationException

La raccolta sottostante è stata modificata all'esterno di questa BlockingCollection<T> istanza oppure è BlockingCollection<T> vuota ed è stata contrassegnata come completa per le aggiunte.

Commenti

Una chiamata a può bloccare fino a Take quando non è disponibile un elemento da rimuovere.

L'ordine in cui un elemento viene rimosso dipende dal tipo di raccolta utilizzato per creare l'istanza di BlockingCollection<T>. Quando si crea un oggetto BlockingCollection<T>, è possibile specificare il tipo di raccolta da utilizzare. Ad esempio, è possibile specificare un oggetto ConcurrentQueue<T> per il comportamento FIFO (First In, First Out) o un oggetto ConcurrentStack<T> per il comportamento LIFO (Last In, First Out). È possibile usare qualsiasi classe di raccolta che implementa l'interfaccia IProducerConsumerCollection<T>. Il tipo di raccolta predefinito per BlockingCollection<T> è ConcurrentQueue<T>.

Vedi anche

• Raccolte thread-safe
• Panoramica di BlockingCollection

Take(CancellationToken)

Source:

BlockingCollection.cs

Rimuove un elemento da 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

Parametri

cancellationToken

CancellationToken

Token che può essere usato per annullare l'operazione "take".

Restituisce

T

Elemento rimosso dalla raccolta.

Eccezioni

OperationCanceledException

L'oggetto CancellationToken viene annullato.

ObjectDisposedException

L'interfaccia BlockingCollection<T> è stata eliminata.

InvalidOperationException

La raccolta sottostante è stata modificata all'esterno di questa BlockingCollection<T> istanza oppure è BlockingCollection<T> vuota ed è stata contrassegnata come completa per le aggiunte.

Commenti

Una chiamata a può bloccare fino a Take quando non è disponibile un elemento da rimuovere o il token viene annullato.

L'ordine in cui un elemento viene rimosso dipende dal tipo di raccolta utilizzato per creare l'istanza di BlockingCollection<T>. Quando si crea un oggetto BlockingCollection<T>, è possibile specificare il tipo di raccolta da utilizzare. Ad esempio, è possibile specificare un oggetto ConcurrentQueue<T> per il comportamento FIFO (First In, First Out) o un oggetto ConcurrentStack<T> per il comportamento LIFO (Last In, First Out). È possibile usare qualsiasi classe di raccolta che implementa l'interfaccia IProducerConsumerCollection<T>. Il tipo di raccolta predefinito per BlockingCollection<T> è ConcurrentQueue<T>.

Vedi anche

• Raccolte thread-safe
• Panoramica di BlockingCollection