BlockingCollection<T>.TryAdd Methode

Definition

Namespace:

System.Collections.Concurrent

Assembly:

System.Collections.Concurrent.dll

Versucht, der BlockingCollection<T> das angegebene Element hinzuzufügen.

Überlädt

TryAdd(T, Int32)	Versucht, das angegebene Element im angegebenen Zeitraum der BlockingCollection<T> hinzuzufügen.
TryAdd(T, Int32, CancellationToken)	Versucht, das angegebene Element unter Berücksichtigung des Abbruchtokens im angegebenen Zeitraum der BlockingCollection<T> hinzuzufügen.
TryAdd(T)	Versucht, der BlockingCollection<T> das angegebene Element hinzuzufügen.
TryAdd(T, TimeSpan)	Versucht, der BlockingCollection<T> das angegebene Element hinzuzufügen.

TryAdd(T, Int32)

Quelle:

BlockingCollection.cs

Versucht, das angegebene Element im angegebenen Zeitraum der BlockingCollection<T> hinzuzufügen.

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

Parameter

item

T

Das Element, das der Auflistung hinzugefügt werden soll.

millisecondsTimeout

Int32

Die Anzahl der Millisekunden, die warten, bis die Auflistung das Element akzeptiert, oder Infinite (-1) unbegrenzt warten.

Gibt zurück

Boolean

true, wenn der Sammlung item innerhalb der angegebenen Zeit hinzugefügt werden konnte, andernfalls FALSE. Wenn das Element ein Duplikat ist und die zugrunde liegende Auflistung keine Duplikate zulässt, wird eine InvalidOperationException ausgelöst.

Ausnahmen

ObjectDisposedException

BlockingCollection<T> wurde verworfen.

ArgumentOutOfRangeException

millisecondsTimeout ist eine negative Zahl, jedoch nicht -1, was einen unbeschränkten Timeout darstellt.

InvalidOperationException

Die BlockingCollection<T> wurde hinsichtlich Hinzufügungen als vollständig markiert.

- oder -

Das Element wurde von der zugrunde liegenden Auflistung nicht akzeptiert.

Weitere Informationen

• Threadsichere Sammlungen
• Übersicht über BlockingCollection

TryAdd(T, Int32, CancellationToken)

Quelle:

BlockingCollection.cs

Versucht, das angegebene Element unter Berücksichtigung des Abbruchtokens im angegebenen Zeitraum der BlockingCollection<T> hinzuzufügen.

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

Parameter

item

T

Das Element, das der Auflistung hinzugefügt werden soll.

millisecondsTimeout

Int32

Die Anzahl der Millisekunden, die warten, bis die Auflistung das Element akzeptiert, oder Infinite (-1) unbegrenzt warten.

cancellationToken

CancellationToken

Ein Abbruchtoken, das überwacht werden soll.

Gibt zurück

Boolean

true, wenn der Sammlung item innerhalb der angegebenen Zeit hinzugefügt werden konnte, andernfalls FALSE. Wenn das Element ein Duplikat ist und die zugrunde liegende Auflistung keine Duplikate zulässt, wird eine InvalidOperationException ausgelöst.

Ausnahmen

OperationCanceledException

Das CancellationToken wird abgebrochen.

ObjectDisposedException

Die BlockingCollection<T> wurde entfernt, oder die zugrundeliegende CancellationTokenSource wurde verworfen.

ArgumentOutOfRangeException

millisecondsTimeout ist eine negative Zahl, jedoch nicht -1, was einen unbeschränkten Timeout darstellt.

InvalidOperationException

Die BlockingCollection<T> wurde hinsichtlich Hinzufügungen als vollständig markiert.

- oder -

Das Element wurde von der zugrunde liegenden Auflistung nicht akzeptiert.

Weitere Informationen

• Threadsichere Sammlungen
• Übersicht über BlockingCollection

TryAdd(T)

Quelle:

BlockingCollection.cs

Versucht, der BlockingCollection<T> das angegebene Element hinzuzufügen.

public:
 bool TryAdd(T item);

public bool TryAdd (T item);

member this.TryAdd : 'T -> bool

Public Function TryAdd (item As T) As Boolean

Parameter

item

T

Das Element, das der Auflistung hinzugefügt werden soll.

Gibt zurück

Boolean

true, wenn item hinzugefügt werden konnte, andernfalls false. Wenn das Element ein Duplikat ist und die zugrunde liegende Auflistung keine Duplikate zulässt, wird eine InvalidOperationException ausgelöst.

Ausnahmen

ObjectDisposedException

BlockingCollection<T> wurde verworfen.

InvalidOperationException

Die BlockingCollection<T> wurde hinsichtlich Hinzufügungen als vollständig markiert.

- oder -

Das Element wurde von der zugrunde liegenden Auflistung nicht akzeptiert.

Hinweise

Wenn die Auflistung eine begrenzte Auflistung ist und voll ist, gibt diese Methode sofort false zurück, ohne das Element hinzuzufügen.

Weitere Informationen

• Threadsichere Sammlungen
• Übersicht über BlockingCollection

TryAdd(T, TimeSpan)

Quelle:

BlockingCollection.cs

Versucht, der BlockingCollection<T> das angegebene Element hinzuzufügen.

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

Parameter

item

T

Das Element, das der Auflistung hinzugefügt werden soll.

timeout

TimeSpan

Eine TimeSpan-Struktur, die die Anzahl der zu wartenden Millisekunden angibt, oder eine TimeSpan-Struktur, die -1 Millisekunden zum unendlichen Warten angibt.

Gibt zurück

Boolean

true, wenn der Sammlung item innerhalb der angegebenen Zeitspanne hinzugefügt werden konnte, andernfalls false.

Ausnahmen

ObjectDisposedException

BlockingCollection<T> wurde verworfen.

ArgumentOutOfRangeException

timeout ist eine andere negative Zahl als -1 Millisekunden, was ein unendliches Timeout darstellt

Oder

timeout ist größer als Int32.MaxValue.

InvalidOperationException

Die BlockingCollection<T> wurde hinsichtlich Hinzufügungen als vollständig markiert.

- oder -

Das Element wurde von der zugrunde liegenden Auflistung nicht akzeptiert.

Weitere Informationen

• Threadsichere Sammlungen
• Übersicht über BlockingCollection