Freigeben über


BlockingCollection<T>.TryAdd Methode

Definition

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
Quelle:
BlockingCollection.cs
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

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

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

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

- oder -

Das Element wurde von der zugrunde liegenden Auflistung nicht akzeptiert.

Weitere Informationen

Gilt für:

TryAdd(T, Int32, CancellationToken)

Quelle:
BlockingCollection.cs
Quelle:
BlockingCollection.cs
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

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

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

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

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

- oder -

Das Element wurde von der zugrunde liegenden Auflistung nicht akzeptiert.

Weitere Informationen

Gilt für:

TryAdd(T)

Quelle:
BlockingCollection.cs
Quelle:
BlockingCollection.cs
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

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

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

Gilt für:

TryAdd(T, TimeSpan)

Quelle:
BlockingCollection.cs
Quelle:
BlockingCollection.cs
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

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

Ausnahmen

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

Oder

timeout ist größer als Int32.MaxValue.

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

- oder -

Das Element wurde von der zugrunde liegenden Auflistung nicht akzeptiert.

Weitere Informationen

Gilt für: