BlockingCollection<T>.TryAdd Méthode

Définition

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)

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 que la collection accepte l’élément ou Infinite (-1) à attendre indéfiniment.

Retours

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

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

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

S’applique à

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.

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 que la collection accepte l’élément ou Infinite (-1) à attendre indéfiniment.

cancellationToken
CancellationToken

Jeton d'annulation à observer.

Retours

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

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

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

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

S’applique à

TryAdd(T)

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

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

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 est pleine, cette méthode retourne immédiatement false sans ajouter l’élément.

Voir aussi

S’applique à

TryAdd(T, TimeSpan)

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

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

Exceptions

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.

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

S’applique à