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)

Source:

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 的负数，而 -1 表示无限期超时。

- 或 -

collections 的计数大于上限（STA 为 62，MTA 为 63）。

ArgumentException

collections 参数是一个长度为 0 的数组，或者包含 NULL 元素，或者至少一个集合已标记为完成添加。

ObjectDisposedException

至少已释放其中一个 BlockingCollection<T> 实例。

另请参阅

• 线程安全集合
• BlockingCollection 概述

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

Source:

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，或表示 -1 毫秒（无限期等待）的 TimeSpan。

返回

Int32

向其添加项的集合在 collections 数组中的索引；如果未能添加项，则为 -1。

例外

ObjectDisposedException

已释放至少一个 BlockingCollection<T> 实例，或已释放创建 cancellationToken 的 CancellationTokenSource。

ArgumentNullException

collections 参数为 null。

ArgumentOutOfRangeException

timeout 为 -1 毫秒以外的负数，表示无限期超时。

- 或 -

timeout 大于 Int32.MaxValue。

- 或 -

collections 的计数大于上限（STA 为 62，MTA 为 63）。

ArgumentException

collections 参数是一个长度为 0 的数组，或者包含 NULL 元素，或者至少一个集合已标记为完成添加。

InvalidOperationException

至少一个基础集合未接受该项。

注解

如果在“添加”操作有空间可用之前取消 cancellationToken，此方法可以提前返回。

另请参阅

• 线程安全集合
• BlockingCollection 概述

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

Source:

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 的负数，而 -1 表示无限期超时。

- 或 -

collections 的计数大于上限（STA 为 62，MTA 为 63）。

ArgumentException

collections 参数是一个长度为 0 的数组，或者包含 NULL 元素，或者至少一个集合已标记为完成添加。

InvalidOperationException

至少一个基础集合未接受该项。

另请参阅

• 线程安全集合
• BlockingCollection 概述

TryAddToAny(BlockingCollection<T>[], T)

Source:

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 概述