BlockingCollection<T>.Add 方法

定义

命名空间:

System.Collections.Concurrent

程序集:

System.Collections.Concurrent.dll

将项添加到 BlockingCollection<T> 中。

重载

Add(T)	将项添加到 BlockingCollection<T> 中。
Add(T, CancellationToken)	将项添加到 BlockingCollection<T> 中。

Add(T)

Source:

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

要添加到集合的项。 该值可以是 null 引用。

例外

ObjectDisposedException

已释放了 BlockingCollection<T>。

InvalidOperationException

BlockingCollection<T> 已标记为完成添加。

- 或 -

基础集合未接受该项。

注解

如果在初始化此 实例 BlockingCollection<T> 时指定了有限容量，则对 Add 的调用可能会阻止，直到有空间可以存储所提供的项。

另请参阅

• 线程安全集合
• BlockingCollection 概述

Add(T, CancellationToken)

Source:

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

要添加到集合的项。 该值可以是 null 引用。

cancellationToken

CancellationToken

要观察的取消标记。

例外

OperationCanceledException

CancellationToken 已取消。

ObjectDisposedException

BlockingCollection<T> 已被释放，或拥有 cancellationToken 的 CancellationTokenSource 已被释放。

InvalidOperationException

BlockingCollection<T> 已标记为完成添加。

- 或 -

基础集合未接受该项。

注解

如果在初始化此实例 BlockingCollection<T> 时指定了有限容量，则对 Add 的调用可能会阻止，直到有空间可用于存储所提供的项。

如果 已取消，cancellationToken此方法可以提前返回 。OperationCanceledException

另请参阅

• 线程安全集合
• BlockingCollection 概述