BlockingCollection<T>.TryAdd 方法

定義

命名空間:

System.Collections.Concurrent

組件:

netstandard.dll, System.Collections.Concurrent.dll

嘗試將指定的項目加入 BlockingCollection<T>。

多載

名稱	Description
TryAdd(T, Int32)	嘗試在指定時間內將指定項目加入 。BlockingCollection<T>
TryAdd(T, Int32, CancellationToken)	嘗試在指定時間內將指定項目加入 ， BlockingCollection<T> 同時觀察取消標記。
TryAdd(T)	嘗試將指定的項目加入 BlockingCollection<T>。
TryAdd(T, TimeSpan)	嘗試將指定的項目加入 BlockingCollection<T>。

TryAdd(T, Int32)

來源:

BlockingCollection.cs

嘗試在指定時間內將指定項目加入 。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 能在指定時間內加入集合;否則為假。 如果該項目是重複的，且底層集合不接受重複的項目，則會拋出 a InvalidOperationException 。

例外狀況

ObjectDisposedException

這些 BlockingCollection<T> 已經被處理掉了。

ArgumentOutOfRangeException

millisecondsTimeout 是除 -1 以外的負數，而 -1 代表無限次超時。

InvalidOperationException

BlockingCollection<T>關於新增內容已被標記為完整。

-或-

底層的催收單位不接受該物品。

另請參閱

• Thread-Safe 合集
• BlockingCollection 概觀

TryAdd(T, Int32, CancellationToken)

來源:

BlockingCollection.cs

嘗試在指定時間內將指定項目加入 ， 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

true 若 item 能在指定時間內加入集合;否則為假。 如果該項目是重複的，且底層集合不接受重複的項目，則會拋出 a InvalidOperationException 。

例外狀況

OperationCanceledException

CancellationToken被取消了。

ObjectDisposedException

BlockingCollection<T>已經被處置，或標的CancellationTokenSource資產已被處置。

ArgumentOutOfRangeException

millisecondsTimeout 是除 -1 以外的負數，而 -1 代表無限次超時。

InvalidOperationException

BlockingCollection<T>關於新增內容已被標記為完整。

-或-

底層的催收單位不接受該物品。

另請參閱

• Thread-Safe 合集
• BlockingCollection 概觀

TryAdd(T)

來源:

BlockingCollection.cs

嘗試將指定的項目加入 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

true若item能加入;否則，。 false 如果該項目是重複的，且底層集合不接受重複的項目，則會拋出 a InvalidOperationException 。

例外狀況

ObjectDisposedException

這些 BlockingCollection<T> 已經被處理掉了。

InvalidOperationException

BlockingCollection<T>關於新增內容已被標記為完整。

-或-

底層的催收單位不接受該物品。

備註

若集合為有界集合且為滿，此方法立即回傳 false，且不加入該項目。

另請參閱

• Thread-Safe 合集
• BlockingCollection 概觀

TryAdd(T, TimeSpan)

來源:

BlockingCollection.cs

嘗試將指定的項目加入 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 A 代表等待的毫秒數，或 A TimeSpan 代表無限等待的 -1 毫秒。

傳回

Boolean

true 若 item 能在指定時間範圍內加入集合;否則， false。

例外狀況

ObjectDisposedException

這些 BlockingCollection<T> 已經被處理掉了。

ArgumentOutOfRangeException

timeout 是除 -1 毫秒外的負數，代表無限次逾時

-或-

timeout 大於 Int32.MaxValue。

InvalidOperationException

BlockingCollection<T>關於新增內容已被標記為完整。

-或-

底層的催收單位不接受該物品。

另請參閱

• Thread-Safe 合集
• BlockingCollection 概觀