BlockingCollection<T>.TryAdd Méthode

Définition

Espace de noms:
System.Collections.Concurrent
Assemblys:
System.dll, System.Collections.Concurrent.dll
Assembly:
System.dll
Assembly:
System.Collections.Concurrent.dll
Assembly:
netstandard.dll

Tente d’ajouter l’élément spécifié au BlockingCollection<T>.

Surcharges

Nom Description
TryAdd(T, Int32)

Tente d’ajouter l’élément spécifié à l’intérieur BlockingCollection<T> de la période spécifiée.
TryAdd(T, Int32, CancellationToken)

Tente d’ajouter l’élément spécifié à l’intérieur BlockingCollection<T> de la période spécifiée, tout en observant un jeton d’annulation.
TryAdd(T)

Tente d’ajouter l’élément spécifié au BlockingCollection<T>.
TryAdd(T, TimeSpan)

Tente d’ajouter l’élément spécifié au BlockingCollection<T>.

TryAdd(T, Int32)

Tente d’ajouter l’élément spécifié à l’intérieur BlockingCollection<T> 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) d’attendre indéfiniment.

Retours

Boolean

true si la item valeur peut être ajoutée à 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 éléments dupliqués, une InvalidOperationException valeur est levée.

Exceptions

ObjectDisposedException

Il BlockingCollection<T> a été supprimé.

ArgumentOutOfRangeException

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

InvalidOperationException

Les BlockingCollection<T> ajouts ont été marqués comme complets.

-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é à l’intérieur BlockingCollection<T> 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) d’attendre indéfiniment.

cancellationToken
CancellationToken

Jeton d’annulation à observer.

Retours

Boolean

true si la item valeur peut être ajoutée à 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 éléments dupliqués, une InvalidOperationException valeur est levée.

Exceptions

OperationCanceledException

L’opération CancellationToken est annulée.

ObjectDisposedException

L’objet BlockingCollection<T> a été supprimé ou sous-jacent CancellationTokenSource a été supprimé.

ArgumentOutOfRangeException

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

InvalidOperationException

Les BlockingCollection<T> ajouts ont été marqués comme complets.

-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é au 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 s’il item pourrait être ajouté ; sinon, false. Si l’élément est un doublon et que la collection sous-jacente n’accepte pas les éléments dupliqués, une InvalidOperationException valeur est levée.

Exceptions

ObjectDisposedException

Il BlockingCollection<T> a été supprimé.

InvalidOperationException

Les BlockingCollection<T> ajouts ont été marqués comme complets.

-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é au 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

Qui TimeSpan représente le nombre de millisecondes à attendre, ou qui TimeSpan représente -1 millisecondes pour attendre indéfiniment.

Retours

Boolean

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

Exceptions

ObjectDisposedException

Il 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

Les BlockingCollection<T> ajouts ont été marqués comme complets.

-ou-

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

Voir aussi

S’applique à