BlockingCollection<T>.Take Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Supprime un élément du BlockingCollection<T>.
Surcharges
| Nom | Description |
|---|---|
| Take() |
Supprime un élément du BlockingCollection<T>. |
| Take(CancellationToken) |
Supprime un élément du BlockingCollection<T>. |
Take()
Supprime un élément du BlockingCollection<T>.
public:
T Take();
public T Take();
member this.Take : unit -> 'T
Public Function Take () As T
Retours
Élément supprimé de la collection.
Exceptions
Il BlockingCollection<T> a été supprimé.
La collection sous-jacente a été modifiée en dehors de cette BlockingCollection<T> instance, ou elle BlockingCollection<T> est vide et a été marquée comme terminée en ce qui concerne les ajouts.
Remarques
Un appel à bloquer peut être bloqué jusqu’à Take ce qu’un élément soit disponible pour être supprimé.
L’ordre dans lequel un élément est supprimé dépend du type de collection utilisé pour créer l’instance BlockingCollection<T> . Lorsque vous créez un BlockingCollection<T> objet, vous pouvez spécifier le type de collection à utiliser. Par exemple, vous pouvez spécifier un objet pour le ConcurrentQueue<T> premier comportement dans, premier sorti (FIFO) ou un ConcurrentStack<T> objet pour le dernier dans, premier sorti (LIFO) comportement. Vous pouvez utiliser n’importe quelle classe de collection qui implémente l’interface IProducerConsumerCollection<T> . Le type de collection par défaut pour BlockingCollection<T> est ConcurrentQueue<T>.
Voir aussi
S’applique à
Take(CancellationToken)
Supprime un élément du 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
Paramètres
- cancellationToken
- CancellationToken
Jeton qui peut être utilisé pour annuler l’opération « take ».
Retours
Élément supprimé de la collection.
Exceptions
L’opération CancellationToken est annulée.
Il BlockingCollection<T> a été supprimé.
La collection sous-jacente a été modifiée en dehors de cette BlockingCollection<T> instance, ou elle BlockingCollection<T> est vide et a été marquée comme terminée en ce qui concerne les ajouts.
Remarques
Un appel peut bloquer jusqu’à Take ce qu’un élément soit disponible pour être supprimé ou que le jeton soit annulé.
L’ordre dans lequel un élément est supprimé dépend du type de collection utilisé pour créer l’instance BlockingCollection<T> . Lorsque vous créez un BlockingCollection<T> objet, vous pouvez spécifier le type de collection à utiliser. Par exemple, vous pouvez spécifier un objet pour le ConcurrentQueue<T> premier comportement dans, premier sorti (FIFO) ou un ConcurrentStack<T> objet pour le dernier dans, premier sorti (LIFO) comportement. Vous pouvez utiliser n’importe quelle classe de collection qui implémente l’interface IProducerConsumerCollection<T> . Le type de collection par défaut pour BlockingCollection<T> est ConcurrentQueue<T>.