BlockingCollection<T>.AddToAny メソッド

定義

指定したいずれかの BlockingCollection<T> インスタンスに、指定した項目を追加します。Adds the specified item to any one of the specified BlockingCollection<T> instances.

オーバーロード

AddToAny(BlockingCollection<T>[], T)

指定したいずれかの BlockingCollection<T> インスタンスに、指定した項目を追加します。Adds the specified item to any one of the specified BlockingCollection<T> instances.

AddToAny(BlockingCollection<T>[], T, CancellationToken)

指定したいずれかの BlockingCollection<T> インスタンスに、指定した項目を追加します。Adds the specified item to any one of the specified BlockingCollection<T> instances.

AddToAny(BlockingCollection<T>[], T)

指定したいずれかの BlockingCollection<T> インスタンスに、指定した項目を追加します。Adds the specified item to any one of the specified BlockingCollection<T> instances.

public:
 static int AddToAny(cli::array <System::Collections::Concurrent::BlockingCollection<T> ^> ^ collections, T item);
public static int AddToAny (System.Collections.Concurrent.BlockingCollection<T>[] collections, T item);
static member AddToAny : System.Collections.Concurrent.BlockingCollection<'T>[] * 'T -> int
Public Shared Function AddToAny (collections As BlockingCollection(Of T)(), item As T) As Integer

パラメーター

collections
BlockingCollection<T>[]

コレクションの配列。The array of collections.

item
T

いずれかのコレクションに追加する項目。The item to be added to one of the collections.

戻り値

Int32

項目が追加された collections 配列内のコレクションのインデックス。The index of the collection in the collections array to which the item was added.

例外

1 つ以上の BlockingCollection<T> インスタンスが破棄されています。At least one of the BlockingCollection<T> instances has been disposed.

collections 引数が null です。The collections argument is null.

collections の数が STA および MTA の最大サイズ (STA の場合は 62、MTA の場合は 63) を超えています。The count of collections is greater than the maximum size of 62 for STA and 63 for MTA.

collections 引数が長さ 0 の配列であるか、NULL 要素がこの引数に含まれます。または 1 つ以上のコレクションが追加完了としてマークされています。The collections argument is a 0-length array or contains a null element, or at least one of collections has been marked as complete for adding.

1 つ以上の基になるコレクションで項目が受け入れられませんでした。At least one underlying collection didn't accept the item.

注釈

すべてのインスタンスが初期化されたときに制限された容量が指定された場合 BlockingCollection<T> 、指定された項目を格納するために、いずれかのコレクションで使用できるようになるまで、AddToAny を呼び出すことができます。If a bounded capacity was specified when all of the BlockingCollection<T> instances were initialized, a call to AddToAny may block until space is available in one of the collections to store the provided item.

適用対象

AddToAny(BlockingCollection<T>[], T, CancellationToken)

指定したいずれかの BlockingCollection<T> インスタンスに、指定した項目を追加します。Adds the specified item to any one of the specified BlockingCollection<T> instances.

public:
 static int AddToAny(cli::array <System::Collections::Concurrent::BlockingCollection<T> ^> ^ collections, T item, System::Threading::CancellationToken cancellationToken);
public static int AddToAny (System.Collections.Concurrent.BlockingCollection<T>[] collections, T item, System.Threading.CancellationToken cancellationToken);
static member AddToAny : System.Collections.Concurrent.BlockingCollection<'T>[] * 'T * System.Threading.CancellationToken -> int
Public Shared Function AddToAny (collections As BlockingCollection(Of T)(), item As T, cancellationToken As CancellationToken) As Integer

パラメーター

collections
BlockingCollection<T>[]

コレクションの配列。The array of collections.

item
T

いずれかのコレクションに追加する項目。The item to be added to one of the collections.

cancellationToken
CancellationToken

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

戻り値

Int32

項目が追加された collections 配列内のコレクションのインデックス。The index of the collection in the collections array to which the item was added.

例外

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

1 つ以上の基になるコレクションで項目が受け入れられませんでした。At least one underlying collection didn't accept the item.

collections 引数が null です。The collections argument is null.

collections の数が STA および MTA の最大サイズ (STA の場合は 62、MTA の場合は 63) を超えています。The count of collections is greater than the maximum size of 62 for STA and 63 for MTA.

collections 引数が長さ 0 の配列であるか、NULL 要素がこの引数に含まれます。または 1 つ以上のコレクションが追加完了としてマークされています。The collections argument is a 0-length array or contains a null element, or at least one of collections has been marked as complete for adding.

1 つ以上の BlockingCollection<T> インスタンスが破棄されているか、cancellationToken を作成した CancellationTokenSource が破棄されています。At least one of the BlockingCollection<T> instances has been disposed, or the CancellationTokenSource that created cancellationToken has been disposed.

注釈

すべてのインスタンスが初期化されたときに制限された容量が指定された場合 BlockingCollection<T> 、指定された項目を格納するために、いずれかのコレクションで使用できるようになるまで、AddToAny を呼び出すことができます。If a bounded capacity was specified when all of the BlockingCollection<T> instances were initialized, a call to AddToAny may block until space is available in one of the collections to store the provided item. cancellationToken領域が使用可能になる前にが取り消された場合、このメソッドは、項目がコレクションに追加される前にを返すことがあります。This method may return before the item is added to any collection if the cancellationToken is canceled before space is available.

適用対象