BlockingCollection<T>.TryAddToAny Метод

Определение

Пространство имен:

System.Collections.Concurrent

Сборка:

System.Collections.Concurrent.dll

Пытается добавить указанный элемент к одному из указанных экземпляров BlockingCollection<T>.

Перегрузки

TryAddToAny(BlockingCollection<T>[], T, Int32, CancellationToken)	Пытается добавить указанный элемент к одному из указанных экземпляров BlockingCollection<T>.
TryAddToAny(BlockingCollection<T>[], T, TimeSpan)	Пытается добавить указанный элемент в любой из указанных экземпляров BlockingCollection<T>, контролируя указанный маркер отмены.
TryAddToAny(BlockingCollection<T>[], T, Int32)	Пытается добавить указанный элемент к одному из указанных экземпляров BlockingCollection<T>.
TryAddToAny(BlockingCollection<T>[], T)	Пытается добавить указанный элемент к одному из указанных экземпляров BlockingCollection<T>.

TryAddToAny(BlockingCollection<T>[], T, Int32, CancellationToken)

Исходный код:

BlockingCollection.cs

Пытается добавить указанный элемент к одному из указанных экземпляров BlockingCollection<T>.

public:
 static int TryAddToAny(cli::array <System::Collections::Concurrent::BlockingCollection<T> ^> ^ collections, T item, int millisecondsTimeout, System::Threading::CancellationToken cancellationToken);

public static int TryAddToAny (System.Collections.Concurrent.BlockingCollection<T>[] collections, T item, int millisecondsTimeout, System.Threading.CancellationToken cancellationToken);

static member TryAddToAny : System.Collections.Concurrent.BlockingCollection<'T>[] * 'T * int * System.Threading.CancellationToken -> int

Public Shared Function TryAddToAny (collections As BlockingCollection(Of T)(), item As T, millisecondsTimeout As Integer, cancellationToken As CancellationToken) As Integer

Параметры

collections

BlockingCollection<T>[]

Массив коллекций.

item

T

Элемент, добавляемый в одну из коллекций.

millisecondsTimeout

Int32

Количество миллисекундах, в течение которых коллекция примет элемент, или Infinite (-1) для неограниченного ожидания.

cancellationToken

CancellationToken

Маркер отмены, который следует контролировать.

Возвращаемое значение

Int32

Индекс коллекции, в которую был добавлен элемент, в массиве collections, или -1, если добавить элемент не удалось.

Исключения

OperationCanceledException

CancellationToken отменен.

InvalidOperationException

Хотя бы одна базовая коллекция не приняла элемент.

ArgumentNullException

Аргумент collections имеет значение NULL.

ArgumentOutOfRangeException

Параметр millisecondsTimeout является отрицательным числом, отличным от –1, что означает бесконечное время ожидания.

-или-

Число collections больше, чем максимальный размер (62 для STA и 63 для MTA).

ArgumentException

collections аргумент является массивом длины 0, содержит элемент null или хотя бы одна коллекция была помечена как готовая для добавления.

ObjectDisposedException

Хотя бы один из экземпляров BlockingCollection<T> был удален.

См. также раздел

• Потокобезопасные коллекции
• Общие сведения о коллекции BlockingCollection

TryAddToAny(BlockingCollection<T>[], T, TimeSpan)

Исходный код:

BlockingCollection.cs

Пытается добавить указанный элемент в любой из указанных экземпляров BlockingCollection<T>, контролируя указанный маркер отмены.

public:
 static int TryAddToAny(cli::array <System::Collections::Concurrent::BlockingCollection<T> ^> ^ collections, T item, TimeSpan timeout);

public static int TryAddToAny (System.Collections.Concurrent.BlockingCollection<T>[] collections, T item, TimeSpan timeout);

static member TryAddToAny : System.Collections.Concurrent.BlockingCollection<'T>[] * 'T * TimeSpan -> int

Public Shared Function TryAddToAny (collections As BlockingCollection(Of T)(), item As T, timeout As TimeSpan) As Integer

Параметры

collections

BlockingCollection<T>[]

Массив коллекций.

item

T

Элемент, добавляемый в одну из коллекций.

timeout

TimeSpan

Период TimeSpan, представляющий время ожидания в миллисекундах, или период TimeSpan, представляющий -1 миллисекунду для неограниченного ожидания.

Возвращаемое значение

Int32

Индекс коллекции, в которую был добавлен элемент, в массиве collections, или -1, если добавить элемент не удалось.

Исключения

ObjectDisposedException

По крайней мере один из экземпляров BlockingCollection<T> или CancellationTokenSource, создавший cancellationToken был удален.

ArgumentNullException

Аргумент collections имеет значение NULL.

ArgumentOutOfRangeException

timeout является отрицательным числом, отличным от -1 миллисекунды, которое представляет неограниченное время ожидания.

-или-

timeout больше , чем Int32.MaxValue.

-или-

Число collections больше, чем максимальный размер (62 для STA и 63 для MTA).

ArgumentException

collections аргумент является массивом длины 0, содержит элемент null или хотя бы одна коллекция была помечена как готовая для добавления.

InvalidOperationException

Хотя бы одна базовая коллекция не приняла элемент.

Комментарии

Этот метод может вернуться раньше, если отмена cancellationToken была отменена до того, как для операции Добавления было доступно место.

См. также раздел

• Потокобезопасные коллекции
• Общие сведения о коллекции BlockingCollection

TryAddToAny(BlockingCollection<T>[], T, Int32)

Исходный код:

BlockingCollection.cs

Пытается добавить указанный элемент к одному из указанных экземпляров BlockingCollection<T>.

public:
 static int TryAddToAny(cli::array <System::Collections::Concurrent::BlockingCollection<T> ^> ^ collections, T item, int millisecondsTimeout);

public static int TryAddToAny (System.Collections.Concurrent.BlockingCollection<T>[] collections, T item, int millisecondsTimeout);

static member TryAddToAny : System.Collections.Concurrent.BlockingCollection<'T>[] * 'T * int -> int

Public Shared Function TryAddToAny (collections As BlockingCollection(Of T)(), item As T, millisecondsTimeout As Integer) As Integer

Параметры

collections

BlockingCollection<T>[]

Массив коллекций.

item

T

Элемент, добавляемый в одну из коллекций.

millisecondsTimeout

Int32

Количество миллисекундах, в течение которых коллекция примет элемент, или Infinite (-1) для неограниченного ожидания.

Возвращаемое значение

Int32

Индекс коллекции, в которую был добавлен элемент, в массиве collections, или -1, если добавить элемент не удалось.

Исключения

ObjectDisposedException

Хотя бы один из экземпляров BlockingCollection<T> был удален.

ArgumentNullException

Аргумент collections имеет значение NULL.

ArgumentOutOfRangeException

Параметр millisecondsTimeout является отрицательным числом, отличным от –1, что означает бесконечное время ожидания.

-или-

Число collections больше, чем максимальный размер (62 для STA и 63 для MTA).

ArgumentException

collections аргумент является массивом длины 0, содержит элемент null или хотя бы одна коллекция была помечена как готовая для добавления.

InvalidOperationException

Хотя бы одна базовая коллекция не приняла элемент.

См. также раздел

• Потокобезопасные коллекции
• Общие сведения о коллекции BlockingCollection

TryAddToAny(BlockingCollection<T>[], T)

Исходный код:

BlockingCollection.cs

Пытается добавить указанный элемент к одному из указанных экземпляров BlockingCollection<T>.

public:
 static int TryAddToAny(cli::array <System::Collections::Concurrent::BlockingCollection<T> ^> ^ collections, T item);

public static int TryAddToAny (System.Collections.Concurrent.BlockingCollection<T>[] collections, T item);

static member TryAddToAny : System.Collections.Concurrent.BlockingCollection<'T>[] * 'T -> int

Public Shared Function TryAddToAny (collections As BlockingCollection(Of T)(), item As T) As Integer

Параметры

collections

BlockingCollection<T>[]

Массив коллекций.

item

T

Элемент, добавляемый в одну из коллекций.

Возвращаемое значение

Int32

Индекс коллекции, в которую был добавлен элемент, в массиве collections, или -1, если добавить элемент не удалось.

Исключения

ObjectDisposedException

Хотя бы один из экземпляров BlockingCollection<T> был удален.

ArgumentNullException

Аргумент collections имеет значение NULL.

ArgumentOutOfRangeException

Число collections больше, чем максимальный размер (62 для STA и 63 для MTA).

ArgumentException

collections аргумент является массивом длины 0, содержит элемент null или хотя бы одна коллекция была помечена как готовая для добавления.

InvalidOperationException

Хотя бы одна базовая коллекция не приняла элемент.

См. также раздел

• Потокобезопасные коллекции
• Общие сведения о коллекции BlockingCollection