BlockingCollection<T>.Add Método

Definição

Namespace:

System.Collections.Concurrent

Assembly:

System.Collections.Concurrent.dll

Adiciona o item ao BlockingCollection<T>.

Sobrecargas

Add(T)	Adiciona o item ao BlockingCollection<T>.
Add(T, CancellationToken)	Adiciona o item ao BlockingCollection<T>.

Add(T)

Origem:

BlockingCollection.cs

Adiciona o item ao BlockingCollection<T>.

public:
 void Add(T item);

public void Add (T item);

member this.Add : 'T -> unit

Public Sub Add (item As T)

Parâmetros

item

T

O item a ser adicionado à coleção. O valor pode ser uma referência nula.

Exceções

ObjectDisposedException

O BlockingCollection<T> foi descartado.

InvalidOperationException

O BlockingCollection<T> foi marcado como concluído com relação a adições.

- ou -

A coleção subjacente não aceitou o item.

Comentários

Se uma capacidade limitada tiver sido especificada quando essa instância de BlockingCollection<T> foi inicializada, uma chamada para Adicionar poderá bloquear até que o espaço esteja disponível para armazenar o item fornecido.

Confira também

• Coleções Thread-Safe
• Visão geral de BlockingCollection

Add(T, CancellationToken)

Origem:

BlockingCollection.cs

Adiciona o item ao BlockingCollection<T>.

public:
 void Add(T item, System::Threading::CancellationToken cancellationToken);

public void Add (T item, System.Threading.CancellationToken cancellationToken);

member this.Add : 'T * System.Threading.CancellationToken -> unit

Public Sub Add (item As T, cancellationToken As CancellationToken)

Parâmetros

item

T

O item a ser adicionado à coleção. O valor pode ser uma referência nula.

cancellationToken

CancellationToken

Um token de cancelamento a ser observado.

Exceções

OperationCanceledException

O CancellationToken está cancelado.

ObjectDisposedException

O BlockingCollection<T> foi descartado ou o CancellationTokenSource que possui o cancellationToken foi descartado.

InvalidOperationException

O BlockingCollection<T> foi marcado como concluído com relação a adições.

- ou -

A coleção subjacente não aceitou o item.

Comentários

Se uma capacidade limitada tiver sido especificada quando essa instância de BlockingCollection<T> foi inicializada, uma chamada para Add poderá ser bloqueada até que o espaço esteja disponível para armazenar o item fornecido.

Esse método pode retornar antecipadamente com um OperationCanceledException se o cancellationToken for cancelado.

Confira também

• Coleções Thread-Safe
• Visão geral de BlockingCollection