BlockingCollection<T>.TryAdd Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Пытается добавить указанный элемент в BlockingCollection<T>.
Перегрузки
| TryAdd(T, Int32) |
Пытается добавить указанный элемент в коллекцию BlockingCollection<T> в течение указанного периода времени. |
| TryAdd(T, Int32, CancellationToken) |
Пытается добавить указанный элемент в коллекцию BlockingCollection<T> в течение указанного периода времени, контролируя маркер отмены. |
| TryAdd(T) |
Пытается добавить указанный элемент в BlockingCollection<T>. |
| TryAdd(T, TimeSpan) |
Пытается добавить указанный элемент в BlockingCollection<T>. |
TryAdd(T, Int32)
- Исходный код:
- BlockingCollection.cs
- Исходный код:
- BlockingCollection.cs
- Исходный код:
- BlockingCollection.cs
Пытается добавить указанный элемент в коллекцию BlockingCollection<T> в течение указанного периода времени.
public:
bool TryAdd(T item, int millisecondsTimeout);public bool TryAdd (T item, int millisecondsTimeout);member this.TryAdd : 'T * int -> boolPublic Function TryAdd (item As T, millisecondsTimeout As Integer) As BooleanПараметры
- item
- T
Элемент, добавляемый в коллекцию.
- millisecondsTimeout
- Int32
Количество миллисекундах, в течение которых коллекция примет элемент, или Infinite (-1) для неограниченного ожидания.
Возвращаемое значение
Значение true, если элемент item удалось добавить в коллекцию в течение указанного времени; в противном случае значение false. Если элемент является дубликатом, а соответствующая коллекция не поддерживает повторяющиеся элементы, создается исключение InvalidOperationException.
Исключения
Объект BlockingCollection<T> удален.
Параметр millisecondsTimeout является отрицательным числом, отличным от –1, что означает бесконечное время ожидания.
Коллекция BlockingCollection<T> была помечена как завершенная в отношении добавлений.
-или-
Указанная коллекция не принимает такой элемент.
См. также раздел
Применяется к
TryAdd(T, Int32, CancellationToken)
- Исходный код:
- BlockingCollection.cs
- Исходный код:
- BlockingCollection.cs
- Исходный код:
- BlockingCollection.cs
Пытается добавить указанный элемент в коллекцию BlockingCollection<T> в течение указанного периода времени, контролируя маркер отмены.
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 -> boolPublic Function TryAdd (item As T, millisecondsTimeout As Integer, cancellationToken As CancellationToken) As BooleanПараметры
- item
- T
Элемент, добавляемый в коллекцию.
- millisecondsTimeout
- Int32
Количество миллисекундах, в течение которых коллекция примет элемент, или Infinite (-1) для неограниченного ожидания.
- cancellationToken
- CancellationToken
Маркер отмены, который следует контролировать.
Возвращаемое значение
Значение true, если элемент item удалось добавить в коллекцию в течение указанного времени; в противном случае значение false. Если элемент является дубликатом, а соответствующая коллекция не поддерживает повторяющиеся элементы, создается исключение InvalidOperationException.
Исключения
Объект BlockingCollection<T> был удален или базовый объект CancellationTokenSource был удален.
Параметр millisecondsTimeout является отрицательным числом, отличным от –1, что означает бесконечное время ожидания.
Коллекция BlockingCollection<T> была помечена как завершенная в отношении добавлений.
-или-
Указанная коллекция не принимает такой элемент.
См. также раздел
Применяется к
TryAdd(T)
- Исходный код:
- BlockingCollection.cs
- Исходный код:
- BlockingCollection.cs
- Исходный код:
- BlockingCollection.cs
Пытается добавить указанный элемент в BlockingCollection<T>.
public:
bool TryAdd(T item);public bool TryAdd (T item);member this.TryAdd : 'T -> boolPublic Function TryAdd (item As T) As BooleanПараметры
- item
- T
Элемент, добавляемый в коллекцию.
Возвращаемое значение
Значение true, если item удалось добавить; в противном случае — значение false. Если элемент является дубликатом, а соответствующая коллекция не поддерживает повторяющиеся элементы, создается исключение InvalidOperationException.
Исключения
Объект BlockingCollection<T> удален.
Коллекция BlockingCollection<T> была помечена как завершенная в отношении добавлений.
-или-
Указанная коллекция не принимает такой элемент.
Комментарии
Если коллекция является ограниченной и заполненной, этот метод немедленно возвращает значение false без добавления элемента.
См. также раздел
Применяется к
TryAdd(T, TimeSpan)
- Исходный код:
- BlockingCollection.cs
- Исходный код:
- BlockingCollection.cs
- Исходный код:
- BlockingCollection.cs
Пытается добавить указанный элемент в BlockingCollection<T>.
public:
bool TryAdd(T item, TimeSpan timeout);public bool TryAdd (T item, TimeSpan timeout);member this.TryAdd : 'T * TimeSpan -> boolPublic Function TryAdd (item As T, timeout As TimeSpan) As BooleanПараметры
- item
- T
Элемент, добавляемый в коллекцию.
- timeout
- TimeSpan
Период TimeSpan, представляющий время ожидания в миллисекундах, или период TimeSpan, представляющий -1 миллисекунду для неограниченного ожидания.
Возвращаемое значение
Значение true, если элемент item удалось добавить в коллекцию в течение указанного промежутка времени; в противном случае значение false.
Исключения
Объект BlockingCollection<T> удален.
timeout — отрицательное число, отличное от –1 миллисекунда, которое представляет бесконечное время ожидания.
-или-
timeout больше , чем Int32.MaxValue.
Коллекция BlockingCollection<T> была помечена как завершенная в отношении добавлений.
-или-
Указанная коллекция не принимает такой элемент.
