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

加入至集合的項目。 這個值可以是 null 參考。

例外狀況

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

加入至集合的項目。 這個值可以是 null 參考。

cancellationToken

CancellationToken

要觀察的取消語彙基元。

例外狀況

OperationCanceledException

CancellationToken 已取消。

ObjectDisposedException

已經處置 BlockingCollection<T>屬性，或者已經處置擁有 cancellationToken 的 CancellationTokenSource。

InvalidOperationException

BlockingCollection<T> 已被標記為已完成加入。

-或-

基礎集合不接受這個項目。

備註

如果在初始化這個 實例 BlockingCollection<T> 時指定了限定容量，則呼叫 Add 可能會封鎖，直到空間可供儲存提供的項目為止。

如果取消 ，cancellationToken這個方法可以提早傳OperationCanceledException回 。

另請參閱

• 安全執行緒集合
• BlockingCollection 概觀