BlockingCollection<T>.TryAdd Metode

Definisi

Ruang nama:

System.Collections.Concurrent

Rakitan:

System.Collections.Concurrent.dll

Mencoba menambahkan item yang ditentukan ke BlockingCollection<T>.

Overload

TryAdd(T, Int32)	Mencoba menambahkan item yang ditentukan ke BlockingCollection<T> dalam periode waktu yang ditentukan.
TryAdd(T, Int32, CancellationToken)	Mencoba menambahkan item yang ditentukan ke BlockingCollection<T> dalam periode waktu yang ditentukan, sambil mengamati token pembatalan.
TryAdd(T)	Mencoba menambahkan item yang ditentukan ke BlockingCollection<T>.
TryAdd(T, TimeSpan)	Mencoba menambahkan item yang ditentukan ke BlockingCollection<T>.

TryAdd(T, Int32)

Sumber:

BlockingCollection.cs

Mencoba menambahkan item yang ditentukan ke BlockingCollection<T> dalam periode waktu yang ditentukan.

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

Parameter

item

T

Item yang akan ditambahkan ke koleksi.

millisecondsTimeout

Int32

Jumlah milidetik untuk menunggu koleksi menerima item, atau Infinite (-1) menunggu tanpa batas waktu.

Mengembalikan

Boolean

trueitem jika dapat ditambahkan ke koleksi dalam waktu yang ditentukan; jika tidak, salah. Jika item adalah duplikat, dan koleksi yang mendasar tidak menerima item duplikat, maka InvalidOperationException akan dilemparkan.

Pengecualian

ObjectDisposedException

Sudah BlockingCollection<T> dibuang.

ArgumentOutOfRangeException

millisecondsTimeout adalah angka negatif selain -1, yang mewakili waktu habis yang tak terbatas.

InvalidOperationException

BlockingCollection<T> telah ditandai sebagai lengkap sehubungan dengan penambahan.

-atau-

Koleksi yang mendasar tidak menerima item.

Lihat juga

• Koleksi yang Aman untuk Utas
• Gambaran Umum BlockingCollection

TryAdd(T, Int32, CancellationToken)

Sumber:

BlockingCollection.cs

Mencoba menambahkan item yang ditentukan ke BlockingCollection<T> dalam periode waktu yang ditentukan, sambil mengamati token pembatalan.

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

Parameter

item

T

Item yang akan ditambahkan ke koleksi.

millisecondsTimeout

Int32

Jumlah milidetik untuk menunggu koleksi menerima item, atau Infinite (-1) menunggu tanpa batas waktu.

cancellationToken

CancellationToken

Token pembatalan untuk diamati.

Mengembalikan

Boolean

trueitem jika dapat ditambahkan ke koleksi dalam waktu yang ditentukan; jika tidak, salah. Jika item adalah duplikat, dan koleksi yang mendasar tidak menerima item duplikat, maka InvalidOperationException akan dilemparkan.

Pengecualian

OperationCanceledException

Dibatalkan CancellationToken .

ObjectDisposedException

BlockingCollection<T> telah dibuang atau yang mendasar CancellationTokenSource telah dibuang.

ArgumentOutOfRangeException

millisecondsTimeout adalah angka negatif selain -1, yang mewakili waktu habis yang tak terbatas.

InvalidOperationException

BlockingCollection<T> telah ditandai sebagai lengkap sehubungan dengan penambahan.

-atau-

Koleksi yang mendasar tidak menerima item.

Lihat juga

• Koleksi yang Aman untuk Utas
• Gambaran Umum BlockingCollection

TryAdd(T)

Sumber:

BlockingCollection.cs

Mencoba menambahkan item yang ditentukan ke 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

Parameter

item

T

Item yang akan ditambahkan ke koleksi.

Mengembalikan

Boolean

true jika item dapat ditambahkan; jika tidak, false. Jika item adalah duplikat, dan koleksi yang mendasar tidak menerima item duplikat, maka InvalidOperationException akan dilemparkan.

Pengecualian

ObjectDisposedException

Sudah BlockingCollection<T> dibuang.

InvalidOperationException

BlockingCollection<T> telah ditandai sebagai lengkap sehubungan dengan penambahan.

-atau-

Koleksi yang mendasar tidak menerima item.

Keterangan

Jika koleksi adalah koleksi terikat, dan penuh, metode ini segera mengembalikan false tanpa menambahkan item.

Lihat juga

• Koleksi yang Aman untuk Utas
• Gambaran Umum BlockingCollection

TryAdd(T, TimeSpan)

Sumber:

BlockingCollection.cs

Mencoba menambahkan item yang ditentukan ke 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

Parameter

item

T

Item yang akan ditambahkan ke koleksi.

timeout

TimeSpan

TimeSpan yang mewakili jumlah milidetik untuk menunggu, atau TimeSpan yang mewakili -1 milidetik untuk menunggu tanpa batas waktu.

Mengembalikan

Boolean

trueitem jika dapat ditambahkan ke koleksi dalam rentang waktu yang ditentukan; jika tidak, false.

Pengecualian

ObjectDisposedException

Sudah BlockingCollection<T> dibuang.

ArgumentOutOfRangeException

timeout adalah angka negatif selain -1 milidetik, yang mewakili batas waktu tak terbatas

-atau-

timeout lebih besar dari Int32.MaxValue.

InvalidOperationException

BlockingCollection<T> telah ditandai sebagai lengkap sehubungan dengan penambahan.

-atau-

Koleksi yang mendasar tidak menerima item.

Lihat juga

• Koleksi yang Aman untuk Utas
• Gambaran Umum BlockingCollection