BlockingCollection<T>.TryAddToAny 方法

定義

命名空間:

System.Collections.Concurrent

組件:

System.Collections.Concurrent.dll

嘗試將指定的項目加入至任何一個指定的 BlockingCollection<T> 執行個體。

多載

TryAddToAny(BlockingCollection<T>[], T, Int32, CancellationToken)	嘗試將指定的項目加入至任何一個指定的 BlockingCollection<T> 執行個體。
TryAddToAny(BlockingCollection<T>[], T, TimeSpan)	當觀察指定的取消語彙基元時，嘗試將指定的項目加入任何一個指定的 BlockingCollection<T> 執行個體。
TryAddToAny(BlockingCollection<T>[], T, Int32)	嘗試將指定的項目加入至任何一個指定的 BlockingCollection<T> 執行個體。
TryAddToAny(BlockingCollection<T>[], T)	嘗試將指定的項目加入至任何一個指定的 BlockingCollection<T> 執行個體。

TryAddToAny(BlockingCollection<T>[], T, Int32, CancellationToken)

來源:

BlockingCollection.cs

嘗試將指定的項目加入至任何一個指定的 BlockingCollection<T> 執行個體。

public:
 static int TryAddToAny(cli::array <System::Collections::Concurrent::BlockingCollection<T> ^> ^ collections, T item, int millisecondsTimeout, System::Threading::CancellationToken cancellationToken);

public static int TryAddToAny (System.Collections.Concurrent.BlockingCollection<T>[] collections, T item, int millisecondsTimeout, System.Threading.CancellationToken cancellationToken);

static member TryAddToAny : System.Collections.Concurrent.BlockingCollection<'T>[] * 'T * int * System.Threading.CancellationToken -> int

Public Shared Function TryAddToAny (collections As BlockingCollection(Of T)(), item As T, millisecondsTimeout As Integer, cancellationToken As CancellationToken) As Integer

參數

collections

BlockingCollection<T>[]

集合的陣列。

item

T

要加入至其中一個集合的項目。

millisecondsTimeout

Int32

等候集合接受專案的毫秒數，或 Infinite (-1) 無限期等候。

cancellationToken

CancellationToken

要觀察的取消語彙基元。

傳回

Int32

要在其中加入項目的 collections 陣列中集合的索引，如果無法加入項目則為 -1。

例外狀況

OperationCanceledException

CancellationToken 已取消。

InvalidOperationException

至少一個基礎集合不接受此項目。

ArgumentNullException

collections 引數為 null。

ArgumentOutOfRangeException

millisecondsTimeout 為 -1 以外的負數，表示無限逾時。

-或-

collections 的計數大於 STA 的上限 62 和 MTA 的上限 63。

ArgumentException

collections 引數是長度為 0 的陣列，或包含 Null 項目，或至少其中一個集合已標記為完成加入。

ObjectDisposedException

至少其中一個 BlockingCollection<T> 執行個體已經處置。

另請參閱

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

TryAddToAny(BlockingCollection<T>[], T, TimeSpan)

來源:

BlockingCollection.cs

當觀察指定的取消語彙基元時，嘗試將指定的項目加入任何一個指定的 BlockingCollection<T> 執行個體。

public:
 static int TryAddToAny(cli::array <System::Collections::Concurrent::BlockingCollection<T> ^> ^ collections, T item, TimeSpan timeout);

public static int TryAddToAny (System.Collections.Concurrent.BlockingCollection<T>[] collections, T item, TimeSpan timeout);

static member TryAddToAny : System.Collections.Concurrent.BlockingCollection<'T>[] * 'T * TimeSpan -> int

Public Shared Function TryAddToAny (collections As BlockingCollection(Of T)(), item As T, timeout As TimeSpan) As Integer

參數

collections

BlockingCollection<T>[]

集合的陣列。

item

T

要加入至其中一個集合的項目。

timeout

TimeSpan

TimeSpan，代表等候毫秒數；或是 TimeSpan，代表無限期等候的 -1 毫秒。

傳回

Int32

要在其中加入項目的 collections 陣列中集合的索引，如果無法加入項目則為 -1。

例外狀況

ObjectDisposedException

至少已經處置其中一個建立了 cancellationToken 的 BlockingCollection<T> 執行個體或 CancellationTokenSource。

ArgumentNullException

collections 引數為 null。

ArgumentOutOfRangeException

timeout 為 -1 毫秒以外的負數，表示無限逾時。

-或-

timeout 大於 Int32.MaxValue。

-或-

collections 的計數大於 STA 的上限 62 和 MTA 的上限 63。

ArgumentException

collections 引數是長度為 0 的陣列，或包含 Null 項目，或至少其中一個集合已標記為完成加入。

InvalidOperationException

至少一個基礎集合不接受此項目。

備註

如果在 Add 作業可用的空間之前取消 cancellationToken，這個方法可以提早傳回。

另請參閱

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

TryAddToAny(BlockingCollection<T>[], T, Int32)

來源:

BlockingCollection.cs

嘗試將指定的項目加入至任何一個指定的 BlockingCollection<T> 執行個體。

public:
 static int TryAddToAny(cli::array <System::Collections::Concurrent::BlockingCollection<T> ^> ^ collections, T item, int millisecondsTimeout);

public static int TryAddToAny (System.Collections.Concurrent.BlockingCollection<T>[] collections, T item, int millisecondsTimeout);

static member TryAddToAny : System.Collections.Concurrent.BlockingCollection<'T>[] * 'T * int -> int

Public Shared Function TryAddToAny (collections As BlockingCollection(Of T)(), item As T, millisecondsTimeout As Integer) As Integer

參數

collections

BlockingCollection<T>[]

集合的陣列。

item

T

要加入至其中一個集合的項目。

millisecondsTimeout

Int32

等候集合接受專案的毫秒數，或 Infinite (-1) 無限期等候。

傳回

Int32

要在其中加入項目的 collections 陣列中集合的索引，如果無法加入項目則為 -1。

例外狀況

ObjectDisposedException

至少其中一個 BlockingCollection<T> 執行個體已經處置。

ArgumentNullException

collections 引數為 null。

ArgumentOutOfRangeException

millisecondsTimeout 為 -1 以外的負數，表示無限逾時。

-或-

collections 的計數大於 STA 的上限 62 和 MTA 的上限 63。

ArgumentException

collections 引數是長度為 0 的陣列，或包含 Null 項目，或至少其中一個集合已標記為完成加入。

InvalidOperationException

至少一個基礎集合不接受此項目。

另請參閱

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

TryAddToAny(BlockingCollection<T>[], T)

來源:

BlockingCollection.cs

嘗試將指定的項目加入至任何一個指定的 BlockingCollection<T> 執行個體。

public:
 static int TryAddToAny(cli::array <System::Collections::Concurrent::BlockingCollection<T> ^> ^ collections, T item);

public static int TryAddToAny (System.Collections.Concurrent.BlockingCollection<T>[] collections, T item);

static member TryAddToAny : System.Collections.Concurrent.BlockingCollection<'T>[] * 'T -> int

Public Shared Function TryAddToAny (collections As BlockingCollection(Of T)(), item As T) As Integer

參數

collections

BlockingCollection<T>[]

集合的陣列。

item

T

要加入至其中一個集合的項目。

傳回

Int32

要在其中加入項目的 collections 陣列中集合的索引，如果無法加入項目則為 -1。

例外狀況

ObjectDisposedException

至少其中一個 BlockingCollection<T> 執行個體已經處置。

ArgumentNullException

collections 引數為 null。

ArgumentOutOfRangeException

collections 的計數大於 STA 的上限 62 和 MTA 的上限 63。

ArgumentException

collections 引數是長度為 0 的陣列，或包含 Null 項目，或至少其中一個集合已標記為完成加入。

InvalidOperationException

至少一個基礎集合不接受此項目。

另請參閱

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