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 呼び出しは、指定された項目を格納するためにスペースが使用可能になるまでブロックされる可能性があります。

が取り消された場合、このメソッドは を使用して OperationCanceledException 早期に cancellationToken を返すことができます。

こちらもご覧ください

• スレッドセーフなコレクション
• BlockingCollection の概要