BlockingCollection<T>.TryAdd Metoda

Definicja

Przestrzeń nazw:

System.Collections.Concurrent

Zestaw:

System.Collections.Concurrent.dll

Próbuje dodać określony element do elementu BlockingCollection<T>.

Przeciążenia

TryAdd(T, Int32)	Próbuje dodać określony element do określonego BlockingCollection<T> okresu.
TryAdd(T, Int32, CancellationToken)	Próbuje dodać określony element do określonego BlockingCollection<T> okresu, obserwując token anulowania.
TryAdd(T)	Próbuje dodać określony element do elementu BlockingCollection<T>.
TryAdd(T, TimeSpan)	Próbuje dodać określony element do elementu BlockingCollection<T>.

TryAdd(T, Int32)

Źródło:

BlockingCollection.cs

Próbuje dodać określony element do określonego BlockingCollection<T> okresu.

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

Parametry

item

T

Element, który ma zostać dodany do kolekcji.

millisecondsTimeout

Int32

Liczba milisekund oczekiwania na zaakceptowanie elementu przez kolekcję lub Infinite (-1) na czas nieokreślony.

Zwraca

Boolean

true jeśli element item można dodać do kolekcji w określonym czasie; w przeciwnym razie wartość false. Jeśli element jest zduplikowany, a podstawowa kolekcja nie akceptuje zduplikowanych elementów, InvalidOperationException zostanie zgłoszony element.

Wyjątki

ObjectDisposedException

Został BlockingCollection<T> usunięty.

ArgumentOutOfRangeException

millisecondsTimeout jest liczbą ujemną inną niż -1, która reprezentuje nieskończony limit czasu.

InvalidOperationException

Element BlockingCollection<T> został oznaczony jako kompletny w odniesieniu do dodatków.

-lub-

Kolekcja bazowa nie akceptowała elementu.

Zobacz też

• Kolekcje bezpieczne wątkowo
• BlockingCollection — Przegląd

TryAdd(T, Int32, CancellationToken)

Źródło:

BlockingCollection.cs

Próbuje dodać określony element do określonego BlockingCollection<T> okresu, obserwując token anulowania.

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

Parametry

item

T

Element, który ma zostać dodany do kolekcji.

millisecondsTimeout

Int32

Liczba milisekund oczekiwania na zaakceptowanie elementu przez kolekcję lub Infinite (-1) na czas nieokreślony.

cancellationToken

CancellationToken

Token anulowania do obserwowania.

Zwraca

Boolean

true jeśli element item można dodać do kolekcji w określonym czasie; w przeciwnym razie wartość false. Jeśli element jest zduplikowany, a podstawowa kolekcja nie akceptuje zduplikowanych elementów, InvalidOperationException zostanie zgłoszony element.

Wyjątki

OperationCanceledException

Element CancellationToken zostanie anulowany.

ObjectDisposedException

Została BlockingCollection<T> usunięta lub baza danych CancellationTokenSource została usunięta.

ArgumentOutOfRangeException

millisecondsTimeout jest liczbą ujemną inną niż -1, która reprezentuje nieskończony limit czasu.

InvalidOperationException

Element BlockingCollection<T> został oznaczony jako kompletny w odniesieniu do dodatków.

-lub-

Kolekcja bazowa nie akceptowała elementu.

Zobacz też

• Kolekcje bezpieczne wątkowo
• BlockingCollection — Przegląd

TryAdd(T)

Źródło:

BlockingCollection.cs

Próbuje dodać określony element do elementu 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

Parametry

item

T

Element, który ma zostać dodany do kolekcji.

Zwraca

Boolean

true jeśli item można dodać; w przeciwnym razie false. Jeśli element jest zduplikowany, a podstawowa kolekcja nie akceptuje zduplikowanych elementów, InvalidOperationException zostanie zgłoszony element.

Wyjątki

ObjectDisposedException

Został BlockingCollection<T> usunięty.

InvalidOperationException

Element BlockingCollection<T> został oznaczony jako kompletny w odniesieniu do dodatków.

-lub-

Kolekcja bazowa nie akceptowała elementu.

Uwagi

Jeśli kolekcja jest powiązana i jest pełna, ta metoda natychmiast zwraca wartość false bez dodawania elementu.

Zobacz też

• Kolekcje bezpieczne wątkowo
• BlockingCollection — Przegląd

TryAdd(T, TimeSpan)

Źródło:

BlockingCollection.cs

Próbuje dodać określony element do elementu 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

Parametry

item

T

Element, który ma zostać dodany do kolekcji.

timeout

TimeSpan

Element TimeSpan reprezentujący liczbę milisekund oczekiwania lub wartość reprezentującą TimeSpan -1 milisekundy oczekiwania na czas nieokreślony.

Zwraca

Boolean

true jeśli element item można dodać do kolekcji w określonym przedziale czasu; w przeciwnym razie false.

Wyjątki

ObjectDisposedException

Został BlockingCollection<T> usunięty.

ArgumentOutOfRangeException

timeout jest liczbą ujemną inną niż -1 milisekund, która reprezentuje nieskończony limit czasu

-lub-

timeout wartość jest większa niż Int32.MaxValue.

InvalidOperationException

Element BlockingCollection<T> został oznaczony jako kompletny w odniesieniu do dodatków.

-lub-

Kolekcja bazowa nie akceptowała elementu.

Zobacz też

• Kolekcje bezpieczne wątkowo
• BlockingCollection — Przegląd