BlockingCollection<T>.TryAdd 方法

定義

命名空間:

System.Collections.Concurrent

組件:

System.Collections.Concurrent.dll

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

如果無法在指定時間內將 item 新增至集合，則為 true；否則為 false。 如果此項目已重複，而且基礎集合不接受重複的項目，就會擲回 InvalidOperationException。

例外狀況

ObjectDisposedException

BlockingCollection<T> 已經處置。

ArgumentOutOfRangeException

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

InvalidOperationException

BlockingCollection<T> 已被標記為已完成加入。

-或-

基礎集合不接受這個項目。

另請參閱

• 安全執行緒集合
• 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

如果無法在指定時間內將 item 新增至集合，則為 true；否則為 false。 如果此項目已重複，而且基礎集合不接受重複的項目，就會擲回 InvalidOperationException。

例外狀況

OperationCanceledException

CancellationToken 已取消。

ObjectDisposedException

BlockingCollection<T> 已處置或基礎 CancellationTokenSource 已經過處置。

ArgumentOutOfRangeException

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

InvalidOperationException

BlockingCollection<T> 已被標記為已完成加入。

-或-

基礎集合不接受這個項目。

另請參閱

• 安全執行緒集合
• 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

若可以新增 item，則為 true；否則為 false。 如果此項目已重複，而且基礎集合不接受重複的項目，就會擲回 InvalidOperationException。

例外狀況

ObjectDisposedException

BlockingCollection<T> 已經處置。

InvalidOperationException

BlockingCollection<T> 已被標記為已完成加入。

-或-

基礎集合不接受這個項目。

備註

如果集合是系結的集合，而且已滿，則此方法會立即傳回 false，而不需要加入專案。

另請參閱

• 安全執行緒集合
• 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，代表等候毫秒數；或是 TimeSpan，代表無限期等候的 -1 毫秒。

傳回

Boolean

如果無法在指定時間範圍內將 item 新增至集合，則為 true；否則為 false。

例外狀況

ObjectDisposedException

BlockingCollection<T> 已經處置。

ArgumentOutOfRangeException

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

-或-

timeout 大於 Int32.MaxValue。

InvalidOperationException

BlockingCollection<T> 已被標記為已完成加入。

-或-

基礎集合不接受這個項目。

另請參閱

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