BlockingCollection<T>.TryAdd Méthode

Définition

Espace de noms:

System.Collections.Concurrent

Assembly:

System.Collections.Concurrent.dll

Tente d'ajouter l'élément spécifié à BlockingCollection<T>.

Surcharges

TryAdd(T, Int32)	Tente d'ajouter l'élément spécifié à BlockingCollection<T> au cours de la période spécifiée.
TryAdd(T, Int32, CancellationToken)	Tente d'ajouter l'élément spécifié à BlockingCollection<T> au cours de la période spécifiée tout en observant un jeton d'annulation.
TryAdd(T)	Tente d'ajouter l'élément spécifié à BlockingCollection<T>.
TryAdd(T, TimeSpan)	Tente d'ajouter l'élément spécifié à BlockingCollection<T>.

TryAdd(T, Int32)

Source:

BlockingCollection.cs

Tente d'ajouter l'élément spécifié à BlockingCollection<T> au cours de la période spécifiée.

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

Paramètres

item

T

Élément à ajouter à la collection.

millisecondsTimeout

Int32

Nombre de millisecondes à attendre pour que la collection accepte l’élément, ou Infinite (-1) pour attendre indéfiniment.

Retours

Boolean

true si item a pu être ajouté à la collection dans le délai spécifié ; sinon, false. Si l’élément est un doublon et que la collection sous-jacente n’accepte pas les doublons, une InvalidOperationException est levée.

Exceptions

ObjectDisposedException

BlockingCollection<T> a été supprimé.

ArgumentOutOfRangeException

millisecondsTimeout est un nombre négatif différent de -1, qui représente un délai d’attente infini.

InvalidOperationException

Le BlockingCollection<T> a été marqué comme complet en ce qui concerne les additions.

- ou -

La collection sous-jacente n'a pas accepté l'élément.

Voir aussi

• Collections thread-safe
• Vue d'ensemble de BlockingCollection

TryAdd(T, Int32, CancellationToken)

Source:

BlockingCollection.cs

Tente d'ajouter l'élément spécifié à BlockingCollection<T> au cours de la période spécifiée tout en observant un jeton d'annulation.

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

Paramètres

item

T

Élément à ajouter à la collection.

millisecondsTimeout

Int32

Nombre de millisecondes à attendre pour que la collection accepte l’élément, ou Infinite (-1) pour attendre indéfiniment.

cancellationToken

CancellationToken

Jeton d'annulation à observer.

Retours

Boolean

true si item a pu être ajouté à la collection dans le délai spécifié ; sinon, false. Si l’élément est un doublon et que la collection sous-jacente n’accepte pas les doublons, une InvalidOperationException est levée.

Exceptions

OperationCanceledException

CancellationToken est annulé.

ObjectDisposedException

BlockingCollection<T> a été supprimé ou le CancellationTokenSource sous-jacent a été supprimé.

ArgumentOutOfRangeException

millisecondsTimeout est un nombre négatif différent de -1, qui représente un délai d’attente infini.

InvalidOperationException

Le BlockingCollection<T> a été marqué comme complet en ce qui concerne les additions.

- ou -

La collection sous-jacente n'a pas accepté l'élément.

Voir aussi

• Collections thread-safe
• Vue d'ensemble de BlockingCollection

TryAdd(T)

Source:

BlockingCollection.cs

Tente d'ajouter l'élément spécifié à 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

Paramètres

item

T

Élément à ajouter à la collection.

Retours

Boolean

true si item peut être ajouté ; sinon, false. Si l’élément est un doublon et que la collection sous-jacente n’accepte pas les doublons, une InvalidOperationException est levée.

Exceptions

ObjectDisposedException

BlockingCollection<T> a été supprimé.

InvalidOperationException

Le BlockingCollection<T> a été marqué comme complet en ce qui concerne les additions.

- ou -

La collection sous-jacente n'a pas accepté l'élément.

Remarques

Si la collection est une collection limitée et qu’elle est complète, cette méthode retourne immédiatement false sans ajouter l’élément.

Voir aussi

• Collections thread-safe
• Vue d'ensemble de BlockingCollection

TryAdd(T, TimeSpan)

Source:

BlockingCollection.cs

Tente d'ajouter l'élément spécifié à 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

Paramètres

item

T

Élément à ajouter à la collection.

timeout

TimeSpan

TimeSpan qui représente le nombre de millièmes de secondes à attendre ou TimeSpan qui représente -1 millième de seconde, pour attendre indéfiniment.

Retours

Boolean

true si item a pu être ajouté à la collection dans l’intervalle de temps spécifié ; sinon, false.

Exceptions

ObjectDisposedException

BlockingCollection<T> a été supprimé.

ArgumentOutOfRangeException

timeout est un nombre négatif autre que -1 millisecondes, qui représente un délai d’attente infini

-ou-

timeout est supérieur à Int32.MaxValue.

InvalidOperationException

Le BlockingCollection<T> a été marqué comme complet en ce qui concerne les additions.

- ou -

La collection sous-jacente n'a pas accepté l'élément.

Voir aussi

• Collections thread-safe
• Vue d'ensemble de BlockingCollection