BlockingCollection<T>.Add Метод

Определение

Пространство имен:

System.Collections.Concurrent

Сборка:

System.Collections.Concurrent.dll

Добавляет элемент в коллекцию BlockingCollection<T>.

Перегрузки

Add(T)	Добавляет элемент в коллекцию BlockingCollection<T>.
Add(T, CancellationToken)	Добавляет элемент в коллекцию BlockingCollection<T>.

Add(T)

Исходный код:

BlockingCollection.cs

Добавляет элемент в коллекцию BlockingCollection<T>.

public:
 void Add(T item);

public void Add (T item);

member this.Add : 'T -> unit

Public Sub Add (item As T)

Параметры

item

T

Элемент, добавляемый в коллекцию. Это значение может быть пустой ссылкой.

Исключения

ObjectDisposedException

Объект BlockingCollection<T> удален.

InvalidOperationException

Коллекция BlockingCollection<T> была помечена как завершенная в отношении добавлений.

-или-

Указанная коллекция не принимает такой элемент.

Комментарии

Если при инициализации этого экземпляра BlockingCollection<T> была указана ограниченная емкость, вызов метода Add может блокироваться, пока не будет доступно место для хранения предоставленного элемента.

См. также раздел

• Потокобезопасные коллекции
• Общие сведения о коллекции BlockingCollection

Add(T, CancellationToken)

Исходный код:

BlockingCollection.cs

Добавляет элемент в коллекцию BlockingCollection<T>.

public:
 void Add(T item, System::Threading::CancellationToken cancellationToken);

public void Add (T item, System.Threading.CancellationToken cancellationToken);

member this.Add : 'T * System.Threading.CancellationToken -> unit

Public Sub Add (item As T, cancellationToken As CancellationToken)

Параметры

item

T

Элемент, добавляемый в коллекцию. Это значение может быть пустой ссылкой.

cancellationToken

CancellationToken

Маркер отмены, который следует контролировать.

Исключения

OperationCanceledException

CancellationToken отменен.

ObjectDisposedException

BlockingCollection<T> был удален, или был удален CancellationTokenSource, которому принадлежит cancellationToken.

InvalidOperationException

Коллекция BlockingCollection<T> была помечена как завершенная в отношении добавлений.

-или-

Указанная коллекция не принимает такой элемент.

Комментарии

Если при инициализации этого экземпляра BlockingCollection<T> была указана ограниченная емкость, вызов Add может блокироваться, пока не будет доступно место для хранения предоставленного элемента.

Этот метод может возвращать рано с помощью , OperationCanceledException если cancellationToken объект отменен.

См. также раздел

• Потокобезопасные коллекции
• Общие сведения о коллекции BlockingCollection