BlockingCollection<T>.TryAdd 方法

定义

命名空间:: System.Collections.Concurrent

程序集:: System.dll, System.Collections.Concurrent.dll

程序集:: System.dll

程序集:: System.Collections.Concurrent.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

尝试将指定的项添加到 .BlockingCollection<T>

重载

名称	说明
TryAdd(T, Int32)	尝试将指定项添加到 BlockingCollection<T> 指定时间段内。
TryAdd(T, Int32, CancellationToken)	尝试将指定项添加到 BlockingCollection<T> 指定时间段内，同时观察取消令牌。
TryAdd(T)	尝试将指定的项添加到 .BlockingCollection<T>
TryAdd(T, TimeSpan)	尝试将指定的项添加到 .BlockingCollection<T>

TryAdd(T, Int32)

尝试将指定项添加到 BlockingCollection<T> 指定时间段内。

public:
 bool TryAdd(T item, int millisecondsTimeout);

public bool TryAdd(T item, int millisecondsTimeout);

member this.TryAdd : 'T * int -> bool

Public Function TryAdd (item As T, millisecondsTimeout As Integer) As Boolean

参数

item: T

要添加到集合中的项。

millisecondsTimeout: Int32

等待集合接受项的毫秒数，或 Infinite （-1）无限期等待。

Boolean

true 如果可以在指定时间内将集合 item 添加到集合，则为 false;否则为 false。如果项是重复项，并且基础集合不接受重复项，则会引发一个 InvalidOperationException 。

例外

ObjectDisposedException

BlockingCollection<T>已处置。

ArgumentOutOfRangeException

millisecondsTimeout 是非 -1 的负数，表示无限超时。

InvalidOperationException

在 BlockingCollection<T> 添加方面，该标记已标记为已完成。

-或-

基础集合不接受该项。

另请参阅

适用于

TryAdd(T, Int32, CancellationToken)

尝试将指定项添加到 BlockingCollection<T> 指定时间段内，同时观察取消令牌。

public:
 bool TryAdd(T item, int millisecondsTimeout, System::Threading::CancellationToken cancellationToken);

public bool TryAdd(T item, int millisecondsTimeout, System.Threading.CancellationToken cancellationToken);

member this.TryAdd : 'T * int * System.Threading.CancellationToken -> bool

Public Function TryAdd (item As T, millisecondsTimeout As Integer, cancellationToken As CancellationToken) As Boolean

参数

item: T

要添加到集合中的项。

millisecondsTimeout: Int32

等待集合接受项的毫秒数，或 Infinite （-1）无限期等待。

cancellationToken: CancellationToken

要观察的取消令牌。

Boolean

例外

OperationCanceledException

CancellationToken取消。

ObjectDisposedException

BlockingCollection<T>已释放或基础CancellationTokenSource已释放。

ArgumentOutOfRangeException

millisecondsTimeout 是非 -1 的负数，表示无限超时。

InvalidOperationException

在 BlockingCollection<T> 添加方面，该标记已标记为已完成。

-或-

基础集合不接受该项。

另请参阅

适用于

TryAdd(T)

尝试将指定的项添加到 .BlockingCollection<T>

public:
 bool TryAdd(T item);

public bool TryAdd(T item);

member this.TryAdd : 'T -> bool

Public Function TryAdd (item As T) As Boolean

参数

item: T

要添加到集合中的项。

Boolean

如果可以添加，则为 /&;否则为 /&; 如果项是重复项，并且基础集合不接受重复项，则会引发一个 InvalidOperationException 。

例外

ObjectDisposedException

BlockingCollection<T>已处置。

InvalidOperationException

在 BlockingCollection<T> 添加方面，该标记已标记为已完成。

-或-

基础集合不接受该项。

注解

如果集合是绑定集合且已满，此方法将立即返回 false，而无需添加项。

另请参阅

适用于

TryAdd(T, TimeSpan)

尝试将指定的项添加到 .BlockingCollection<T>

public:
 bool TryAdd(T item, TimeSpan timeout);

public bool TryAdd(T item, TimeSpan timeout);

member this.TryAdd : 'T * TimeSpan -> bool

Public Function TryAdd (item As T, timeout As TimeSpan) As Boolean

参数

item: T

要添加到集合中的项。

timeout: TimeSpan

一个 TimeSpan 表示等待的毫秒数，或 TimeSpan 表示要无限期等待的 -1 毫秒。

Boolean

如果可以在指定的时间跨度内将集合添加到集合，则为。

例外

ObjectDisposedException

BlockingCollection<T>已处置。

ArgumentOutOfRangeException

timeout 是非 -1 毫秒的负数，表示无限超时

-或-

timeout 大于 Int32.MaxValue。

InvalidOperationException

在 BlockingCollection<T> 添加方面，该标记已标记为已完成。

-或-

基础集合不接受该项。

另请参阅

适用于

反馈

此页面是否有帮助？