BlockingCollection<T>.TryAdd Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Collections.Concurrent

Zestaw:: System.Collections.Concurrent.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Przeciążenia

TryAdd(T, Int32)	Próbuje dodać określony element do BlockingCollection<T> obiektu w określonym przedziale czasu.
TryAdd(T, Int32, CancellationToken)	Próbuje dodać określony element do BlockingCollection<T> elementu w określonym przedziale czasu, 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)

Próbuje dodać określony element do BlockingCollection<T> obiektu w określonym przedziale czasu.

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) oczekiwania na czas nieokreślony.

Zwraca

Boolean

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

Wyjątki

ObjectDisposedException

Element BlockingCollection<T> został 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-

Podstawowa kolekcja nie akceptowała elementu.

Zobacz też

Dotyczy

TryAdd(T, Int32, CancellationToken)

Próbuje dodać określony element do BlockingCollection<T> elementu w określonym przedziale czasu, 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) oczekiwania na czas nieokreślony.

cancellationToken: CancellationToken

Token anulowania do obserwowania.

Zwraca

Boolean

Wyjątki

OperationCanceledException

Element CancellationToken zostanie anulowany.

ObjectDisposedException

Element BlockingCollection<T> został usunięty lub CancellationTokenSource podstawowy został 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-

Podstawowa kolekcja nie akceptowała elementu.

Zobacz też

Dotyczy

TryAdd(T)

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 duplikatem, a kolekcja bazowa nie akceptuje zduplikowanych elementów, InvalidOperationException zostanie zgłoszony element .

Wyjątki

ObjectDisposedException

Element BlockingCollection<T> został usunięty.

InvalidOperationException

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

-lub-

Podstawowa kolekcja 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ż

Dotyczy

TryAdd(T, TimeSpan)

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

Wartość TimeSpan reprezentująca liczbę milisekund oczekiwania lub wartość reprezentująca TimeSpan -1 milisekundy oczekiwania na czas nieokreślony.

Zwraca

Boolean

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

Wyjątki

ObjectDisposedException

Element BlockingCollection<T> został usunięty.

ArgumentOutOfRangeException

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

-lub-

timeout parametr jest większy niż Int32.MaxValue.

InvalidOperationException

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

-lub-

Podstawowa kolekcja nie akceptowała elementu.

Zobacz też

Dotyczy