BlockingCollection<T>.TryAdd Metodo

Definizione

Spazio dei nomi:

System.Collections.Concurrent

Assembly:

System.Collections.Concurrent.dll

Prova ad aggiungere l'elemento specificato a BlockingCollection<T>.

Overload

TryAdd(T, Int32)	Prova ad aggiungere l'elemento specificato a BlockingCollection<T> nel periodo di tempo specificato.
TryAdd(T, Int32, CancellationToken)	Prova ad aggiungere l'elemento specificato a BlockingCollection<T> nel periodo di tempo specificato, considerando un token di annullamento.
TryAdd(T)	Prova ad aggiungere l'elemento specificato a BlockingCollection<T>.
TryAdd(T, TimeSpan)	Prova ad aggiungere l'elemento specificato a BlockingCollection<T>.

TryAdd(T, Int32)

Origine:

BlockingCollection.cs

Prova ad aggiungere l'elemento specificato a BlockingCollection<T> nel 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 alla raccolta.

millisecondsTimeout

Int32

Numero di millisecondi da attendere per l'accettazione indefinita dell'elemento o Infinite (-1).

Restituisce

Boolean

true se è stato possibile aggiungere item alla raccolta entro il tempo specificato. In caso contrario, false. Se l'elemento è un duplicato e la raccolta sottostante non accetta elementi duplicati, viene generato un oggetto InvalidOperationException.

Eccezioni

ObjectDisposedException

L'interfaccia BlockingCollection<T> è stata eliminata.

ArgumentOutOfRangeException

millisecondsTimeout è un numero negativo diverso da -1, che rappresenta un timeout infinito.

InvalidOperationException

BlockingCollection<T> è stato contrassegnato come completo in relazione alle aggiunte.

-oppure-

La raccolta sottostante non ha accettato l'elemento.

Vedi anche

• Raccolte thread-safe
• Panoramica di BlockingCollection

TryAdd(T, Int32, CancellationToken)

Origine:

BlockingCollection.cs

Prova ad aggiungere l'elemento specificato a BlockingCollection<T> nel periodo di tempo specificato, considerando 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 alla raccolta.

millisecondsTimeout

Int32

Numero di millisecondi da attendere per l'accettazione indefinita dell'elemento o Infinite (-1).

cancellationToken

CancellationToken

Token di annullamento da osservare.

Restituisce

Boolean

true se è stato possibile aggiungere item alla raccolta entro il tempo specificato. In caso contrario, false. Se l'elemento è un duplicato e la raccolta sottostante non accetta elementi duplicati, viene generato un oggetto InvalidOperationException.

Eccezioni

OperationCanceledException

L'oggetto CancellationToken viene annullato.

ObjectDisposedException

BlockingCollection<T> è stato eliminato o l'oggetto CancellationTokenSource sottostante è stato eliminato.

ArgumentOutOfRangeException

millisecondsTimeout è un numero negativo diverso da -1, che rappresenta un timeout infinito.

InvalidOperationException

BlockingCollection<T> è stato contrassegnato come completo in relazione alle aggiunte.

-oppure-

La raccolta sottostante non ha accettato l'elemento.

Vedi anche

• Raccolte thread-safe
• Panoramica di BlockingCollection

TryAdd(T)

Origine:

BlockingCollection.cs

Prova ad aggiungere l'elemento specificato a 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 alla raccolta.

Restituisce

Boolean

true se è possibile aggiungere item; in caso contrario, false. Se l'elemento è un duplicato e la raccolta sottostante non accetta elementi duplicati, viene generato un oggetto InvalidOperationException.

Eccezioni

ObjectDisposedException

L'interfaccia BlockingCollection<T> è stata eliminata.

InvalidOperationException

BlockingCollection<T> è stato contrassegnato come completo in relazione alle aggiunte.

-oppure-

La raccolta sottostante non ha accettato l'elemento.

Commenti

Se la raccolta è una raccolta associata e è completa, questo metodo restituisce immediatamente false senza aggiungere l'elemento.

Vedi anche

• Raccolte thread-safe
• Panoramica di BlockingCollection

TryAdd(T, TimeSpan)

Origine:

BlockingCollection.cs

Prova ad aggiungere l'elemento specificato a 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 alla raccolta.

timeout

TimeSpan

Oggetto TimeSpan che rappresenta il numero di millisecondi di attesa oppure TimeSpan che rappresenta -1 millisecondi per un'attesa indefinita.

Restituisce

Boolean

true se è stato possibile aggiungere item alla raccolta nell'intervallo di tempo specificato. In caso contrario, false.

Eccezioni

ObjectDisposedException

L'interfaccia BlockingCollection<T> è stata eliminata.

ArgumentOutOfRangeException

timeout è un numero negativo diverso da -1 millisecondi, che rappresenta un timeout infinito

-oppure-

timeout è maggiore di Int32.MaxValue.

InvalidOperationException

BlockingCollection<T> è stato contrassegnato come completo in relazione alle aggiunte.

-oppure-

La raccolta sottostante non ha accettato l'elemento.

Vedi anche

• Raccolte thread-safe
• Panoramica di BlockingCollection