BlockingCollection<T>.TryAdd Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Tenta adicionar o item especificado ao BlockingCollection<T>.
Sobrecargas
| TryAdd(T, Int32) |
Tenta adicionar o item especificado à BlockingCollection<T> dentro do período de tempo especificado. |
| TryAdd(T, Int32, CancellationToken) |
Tenta adicionar o item especificado ao BlockingCollection<T> no período especificado, enquanto observa um token de cancelamento. |
| TryAdd(T) |
Tenta adicionar o item especificado ao BlockingCollection<T>. |
| TryAdd(T, TimeSpan) |
Tenta adicionar o item especificado ao BlockingCollection<T>. |
TryAdd(T, Int32)
- Origem:
- BlockingCollection.cs
- Origem:
- BlockingCollection.cs
- Origem:
- BlockingCollection.cs
Tenta adicionar o item especificado à BlockingCollection<T> dentro do período de tempo especificado.
public:
bool TryAdd(T item, int millisecondsTimeout);public bool TryAdd (T item, int millisecondsTimeout);member this.TryAdd : 'T * int -> boolPublic Function TryAdd (item As T, millisecondsTimeout As Integer) As BooleanParâmetros
- item
- T
O item a ser adicionado à coleção.
- millisecondsTimeout
- Int32
O número de milissegundos a aguardar até que a coleção aceite o item ou Infinite (-1) aguarde indefinidamente.
Retornos
true se o item puder ser adicionado à coleção dentro do tempo especificado, caso contrário, false. Se o item for duplicado e a coleção subjacente não aceitar itens duplicados, será gerada uma InvalidOperationException.
Exceções
O BlockingCollection<T> foi descartado.
millisecondsTimeout é um número negativo diferente de -1, que representa um tempo limite infinito.
O BlockingCollection<T> foi marcado como concluído com relação a adições.
- ou -
A coleção subjacente não aceitou o item.
Confira também
Aplica-se a
TryAdd(T, Int32, CancellationToken)
- Origem:
- BlockingCollection.cs
- Origem:
- BlockingCollection.cs
- Origem:
- BlockingCollection.cs
Tenta adicionar o item especificado ao BlockingCollection<T> no período especificado, enquanto observa um token de cancelamento.
public:
bool TryAdd(T item, int millisecondsTimeout, System::Threading::CancellationToken cancellationToken);public bool TryAdd (T item, int millisecondsTimeout, System.Threading.CancellationToken cancellationToken);member this.TryAdd : 'T * int * System.Threading.CancellationToken -> boolPublic Function TryAdd (item As T, millisecondsTimeout As Integer, cancellationToken As CancellationToken) As BooleanParâmetros
- item
- T
O item a ser adicionado à coleção.
- millisecondsTimeout
- Int32
O número de milissegundos a aguardar até que a coleção aceite o item ou Infinite (-1) aguarde indefinidamente.
- cancellationToken
- CancellationToken
Um token de cancelamento a ser observado.
Retornos
true se o item puder ser adicionado à coleção dentro do tempo especificado, caso contrário, false. Se o item for duplicado e a coleção subjacente não aceitar itens duplicados, será gerada uma InvalidOperationException.
Exceções
O CancellationToken está cancelado.
O BlockingCollection<T> foi descartado ou o CancellationTokenSource subjacente foi descartado.
millisecondsTimeout é um número negativo diferente de -1, que representa um tempo limite infinito.
O BlockingCollection<T> foi marcado como concluído com relação a adições.
- ou -
A coleção subjacente não aceitou o item.
Confira também
Aplica-se a
TryAdd(T)
- Origem:
- BlockingCollection.cs
- Origem:
- BlockingCollection.cs
- Origem:
- BlockingCollection.cs
Tenta adicionar o item especificado ao BlockingCollection<T>.
public:
bool TryAdd(T item);public bool TryAdd (T item);member this.TryAdd : 'T -> boolPublic Function TryAdd (item As T) As BooleanParâmetros
- item
- T
O item a ser adicionado à coleção.
Retornos
true se item pôde ser adicionado; caso contrário, false. Se o item for duplicado e a coleção subjacente não aceitar itens duplicados, será gerada uma InvalidOperationException.
Exceções
O BlockingCollection<T> foi descartado.
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 a coleção for uma coleção limitada e estiver cheia, esse método retornará false imediatamente sem adicionar o item.
Confira também
Aplica-se a
TryAdd(T, TimeSpan)
- Origem:
- BlockingCollection.cs
- Origem:
- BlockingCollection.cs
- Origem:
- BlockingCollection.cs
Tenta adicionar o item especificado ao BlockingCollection<T>.
public:
bool TryAdd(T item, TimeSpan timeout);public bool TryAdd (T item, TimeSpan timeout);member this.TryAdd : 'T * TimeSpan -> boolPublic Function TryAdd (item As T, timeout As TimeSpan) As BooleanParâmetros
- item
- T
O item a ser adicionado à coleção.
- timeout
- TimeSpan
Um TimeSpan que representa o número de milissegundos para aguardar ou um TimeSpan que representa -1 milissegundos para aguardar indefinidamente.
Retornos
true se o item puder ser adicionado à coleção dentro do tempo especificado, caso contrário, false.
Exceções
O BlockingCollection<T> foi descartado.
timeout é um número negativo diferente de -1 milissegundos, que representa um tempo limite infinito
-ou-
timeout é maior que Int32.MaxValue.
O BlockingCollection<T> foi marcado como concluído com relação a adições.
- ou -
A coleção subjacente não aceitou o item.
