BlockingCollection<T>.TryAdd Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
BlockingCollection<T> 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, 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
Das CancellationToken wird abgebrochen.
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
BlockingCollection<T> wurde verworfen.
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
BlockingCollection<T> wurde verworfen.
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.