BlockingCollection<T>.TryAdd Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Prova ad aggiungere l'elemento specificato all'oggetto BlockingCollection<T>.
Overload
| Nome | Descrizione |
|---|---|
| TryAdd(T, Int32) |
Prova ad aggiungere l'elemento specificato all'oggetto BlockingCollection<T> entro il periodo di tempo specificato. |
| TryAdd(T, Int32, CancellationToken) |
Prova ad aggiungere l'elemento specificato all'oggetto BlockingCollection<T> entro il periodo di tempo specificato, osservando un token di annullamento. |
| TryAdd(T) |
Prova ad aggiungere l'elemento specificato all'oggetto BlockingCollection<T>. |
| TryAdd(T, TimeSpan) |
Prova ad aggiungere l'elemento specificato all'oggetto BlockingCollection<T>. |
TryAdd(T, Int32)
Prova ad aggiungere l'elemento specificato all'oggetto BlockingCollection<T> entro il periodo di tempo specificato.
public:
bool TryAdd(T item, int millisecondsTimeout);
public bool TryAdd(T item, int millisecondsTimeout);
member this.TryAdd : 'T * int -> bool
Public Function TryAdd (item As T, millisecondsTimeout As Integer) As Boolean
Parametri
- item
- T
Elemento da aggiungere all'insieme.
- millisecondsTimeout
- Int32
Numero di millisecondi di attesa per l'accettazione dell'elemento da parte della raccolta o Infinite (-1) di attesa illimitata.
Valori restituiti
true se l'oggetto item può essere aggiunto alla raccolta entro l'ora specificata; in caso contrario, false. Se l'elemento è un duplicato e la raccolta sottostante non accetta elementi duplicati, viene generata un'eccezione InvalidOperationException .
Eccezioni
L'oggetto BlockingCollection<T> è stato eliminato.
millisecondsTimeout è un numero negativo diverso da -1, che rappresenta un timeout infinito.
L'oggetto BlockingCollection<T> è stato contrassegnato come completo per quanto riguarda le aggiunte.
oppure
La raccolta sottostante non ha accettato l'elemento.
Vedi anche
Si applica a
TryAdd(T, Int32, CancellationToken)
Prova ad aggiungere l'elemento specificato all'oggetto BlockingCollection<T> entro il periodo di tempo specificato, osservando un token di annullamento.
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 -> bool
Public Function TryAdd (item As T, millisecondsTimeout As Integer, cancellationToken As CancellationToken) As Boolean
Parametri
- item
- T
Elemento da aggiungere all'insieme.
- millisecondsTimeout
- Int32
Numero di millisecondi di attesa per l'accettazione dell'elemento da parte della raccolta o Infinite (-1) di attesa illimitata.
- cancellationToken
- CancellationToken
Token di annullamento da osservare.
Valori restituiti
true se l'oggetto item può essere aggiunto alla raccolta entro l'ora specificata; in caso contrario, false. Se l'elemento è un duplicato e la raccolta sottostante non accetta elementi duplicati, viene generata un'eccezione InvalidOperationException .
Eccezioni
L'oggetto CancellationToken viene annullato.
L'oggetto BlockingCollection<T> è stato eliminato o l'oggetto sottostante CancellationTokenSource è stato eliminato.
millisecondsTimeout è un numero negativo diverso da -1, che rappresenta un timeout infinito.
L'oggetto BlockingCollection<T> è stato contrassegnato come completo per quanto riguarda le aggiunte.
oppure
La raccolta sottostante non ha accettato l'elemento.
Vedi anche
Si applica a
TryAdd(T)
Prova ad aggiungere l'elemento specificato all'oggetto BlockingCollection<T>.
public:
bool TryAdd(T item);
public bool TryAdd(T item);
member this.TryAdd : 'T -> bool
Public Function TryAdd (item As T) As Boolean
Parametri
- item
- T
Elemento da aggiungere all'insieme.
Valori restituiti
true se item può essere aggiunto; in caso contrario, false. Se l'elemento è un duplicato e la raccolta sottostante non accetta elementi duplicati, viene generata un'eccezione InvalidOperationException .
Eccezioni
L'oggetto BlockingCollection<T> è stato eliminato.
L'oggetto BlockingCollection<T> è stato contrassegnato come completo per quanto riguarda le aggiunte.
oppure
La raccolta sottostante non ha accettato l'elemento.
Commenti
Se l'insieme è un insieme delimitato e è pieno, questo metodo restituisce immediatamente false senza aggiungere l'elemento.
Vedi anche
Si applica a
TryAdd(T, TimeSpan)
Prova ad aggiungere l'elemento specificato all'oggetto BlockingCollection<T>.
public:
bool TryAdd(T item, TimeSpan timeout);
public bool TryAdd(T item, TimeSpan timeout);
member this.TryAdd : 'T * TimeSpan -> bool
Public Function TryAdd (item As T, timeout As TimeSpan) As Boolean
Parametri
- item
- T
Elemento da aggiungere all'insieme.
- timeout
- TimeSpan
Oggetto TimeSpan che rappresenta il numero di millisecondi di attesa o un oggetto TimeSpan che rappresenta -1 millisecondi di attesa illimitata.
Valori restituiti
true se l'oggetto item può essere aggiunto alla raccolta entro l'intervallo di tempo specificato; in caso contrario, false.
Eccezioni
L'oggetto BlockingCollection<T> è stato eliminato.
timeout è un numero negativo diverso da -1 millisecondi, che rappresenta un timeout infinito
oppure
timeout è maggiore di Int32.MaxValue.
L'oggetto BlockingCollection<T> è stato contrassegnato come completo per quanto riguarda le aggiunte.
oppure
La raccolta sottostante non ha accettato l'elemento.