BlockingCollection<T>.Add メソッド

定義

BlockingCollection<T> に項目を追加します。Adds the item to the BlockingCollection<T>.

オーバーロード

Add(T)

BlockingCollection<T> に項目を追加します。Adds the item to the BlockingCollection<T>.

Add(T, CancellationToken)

BlockingCollection<T> に項目を追加します。Adds the item to the BlockingCollection<T>.

Add(T)

BlockingCollection<T> に項目を追加します。Adds the item to the 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

コレクションに追加する項目。The item to be added to the collection. この値は null 参照でもかまいません。The value can be a null reference.

例外

BlockingCollection<T> は破棄されています。The BlockingCollection<T> has been disposed.

BlockingCollection<T> は、追加に関して完了としてマークされました。The BlockingCollection<T> has been marked as complete with regards to additions.

- または --or- 基になるコレクションが項目を受け入れませんでした。The underlying collection didn't accept the item.

注釈

のこのインスタンスが初期化されたときに、容量が制限されている場合は、 BlockingCollection<T> 指定された項目を格納するための領域が使用可能になるまで、Add の呼び出しがブロックされることがあります。If a bounded capacity was specified when this instance of BlockingCollection<T> was initialized, a call to Add may block until space is available to store the provided item.

適用対象

Add(T, CancellationToken)

BlockingCollection<T> に項目を追加します。Adds the item to the 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

コレクションに追加する項目。The item to be added to the collection. この値は null 参照でもかまいません。The value can be a null reference.

cancellationToken
CancellationToken

観察するキャンセル トークン。A cancellation token to observe.

例外

CancellationToken が取り消されている場合。If the CancellationToken is canceled.

BlockingCollection<T> が破棄されているか、cancellationToken を所有する CancellationTokenSource が破棄されています。The BlockingCollection<T> has been disposed or the CancellationTokenSource that owns cancellationToken has been disposed.

BlockingCollection<T> は、追加に関して完了としてマークされました。The BlockingCollection<T> has been marked as complete with regards to additions.

- または --or- 基になるコレクションが項目を受け入れませんでした。The underlying collection didn't accept the item.

注釈

のこのインスタンスが初期化されたときに容量が制限されている場合 BlockingCollection<T>Add 指定された項目を格納するための領域が使用できるようになるまで、の呼び出しがブロックされることがあります。If a bounded capacity was specified when this instance of BlockingCollection<T> was initialized, a call to Add may block until space is available to store the provided item.

が取り消された場合、このメソッドはを使用して早期に戻ることができ OperationCanceledException cancellationToken ます。This method can return early with an OperationCanceledException if the cancellationToken is canceled.

適用対象