BlockingCollection<T>.TryAddToAny Método

Definição

Namespace:

System.Collections.Concurrent

Assembly:

System.Collections.Concurrent.dll

Tenta adicionar o item especificado a qualquer uma das instâncias BlockingCollection<T> especificadas.

Sobrecargas

TryAddToAny(BlockingCollection<T>[], T, Int32, CancellationToken)	Tenta adicionar o item especificado a qualquer uma das instâncias BlockingCollection<T> especificadas.
TryAddToAny(BlockingCollection<T>[], T, TimeSpan)	Tenta adicionar o item especificado a qualquer uma das instâncias BlockingCollection<T> especificadas, observando ao mesmo tempo o token de cancelamento especificado.
TryAddToAny(BlockingCollection<T>[], T, Int32)	Tenta adicionar o item especificado a qualquer uma das instâncias BlockingCollection<T> especificadas.
TryAddToAny(BlockingCollection<T>[], T)	Tenta adicionar o item especificado a qualquer uma das instâncias BlockingCollection<T> especificadas.

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

Origem:

BlockingCollection.cs

Tenta adicionar o item especificado a qualquer uma das instâncias BlockingCollection<T> especificadas.

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

Parâmetros

collections

BlockingCollection<T>[]

A matriz de coleções.

item

T

O item a ser adicionado a uma das coleções.

millisecondsTimeout

Int32

O número de milissegundos a aguardar até que a coleção aceite o item ou Infinite (-1) aguarde indefinidamente.

cancellationToken

CancellationToken

Um token de cancelamento a ser observado.

Retornos

Int32

O índice da coleção na matriz collections ao qual o item foi adicionado ou -1 caso o item não possa ser adicionado.

Exceções

OperationCanceledException

O CancellationToken está cancelado.

InvalidOperationException

Pelo menos uma coleção subjacente não aceitou o item.

ArgumentNullException

O argumento collections é nulo.

ArgumentOutOfRangeException

millisecondsTimeout é um número negativo diferente de -1, que representa um tempo limite infinito.

- ou -

A contagem de collections é maior que o tamanho máximo de 62 para STA e 63 para MTA.

ArgumentException

O argumento collections é uma matriz de tamanho 0 ou contém um elemento nulo, ou pelo menos uma das coleções foi marcada como completa para adição.

ObjectDisposedException

Pelo menos uma das instâncias de BlockingCollection<T> foi descartada.

Confira também

• Coleções Thread-Safe
• Visão geral de BlockingCollection

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

Origem:

BlockingCollection.cs

Tenta adicionar o item especificado a qualquer uma das instâncias BlockingCollection<T> especificadas, observando ao mesmo tempo o token de cancelamento especificado.

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

Parâmetros

collections

BlockingCollection<T>[]

A matriz de coleções.

item

T

O item a ser adicionado a uma das coleções.

timeout

TimeSpan

Um TimeSpan que representa o número de milissegundos para aguardar ou um TimeSpan que representa -1 milissegundos para aguardar indefinidamente.

Retornos

Int32

O índice da coleção na matriz collections ao qual o item foi adicionado ou -1 caso o item não possa ser adicionado.

Exceções

ObjectDisposedException

Pelo menos uma das instâncias BlockingCollection<T> ou o CancellationTokenSource que criou cancellationToken foi descartado.

ArgumentNullException

O argumento collections é nulo.

ArgumentOutOfRangeException

timeout é um número negativo diferente de -1 milissegundo, que representa um tempo limite infinito.

- ou -

timeout é maior que Int32.MaxValue.

- ou -

A contagem de collections é maior que o tamanho máximo de 62 para STA e 63 para MTA.

ArgumentException

O argumento collections é uma matriz de tamanho 0 ou contém um elemento nulo, ou pelo menos uma das coleções foi marcada como completa para adição.

InvalidOperationException

Pelo menos uma coleção subjacente não aceitou o item.

Comentários

Esse método poderá retornar antecipadamente se cancellationToken for cancelado antes que o espaço esteja disponível para a operação Add.

Confira também

• Coleções Thread-Safe
• Visão geral de BlockingCollection

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

Origem:

BlockingCollection.cs

Tenta adicionar o item especificado a qualquer uma das instâncias BlockingCollection<T> especificadas.

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

Parâmetros

collections

BlockingCollection<T>[]

A matriz de coleções.

item

T

O item a ser adicionado a uma das coleções.

millisecondsTimeout

Int32

O número de milissegundos a aguardar até que a coleção aceite o item ou Infinite (-1) aguarde indefinidamente.

Retornos

Int32

O índice da coleção na matriz collections ao qual o item foi adicionado ou -1 caso o item não possa ser adicionado.

Exceções

ObjectDisposedException

Pelo menos uma das instâncias de BlockingCollection<T> foi descartada.

ArgumentNullException

O argumento collections é nulo.

ArgumentOutOfRangeException

millisecondsTimeout é um número negativo diferente de -1, que representa um tempo limite infinito.

- ou -

A contagem de collections é maior que o tamanho máximo de 62 para STA e 63 para MTA.

ArgumentException

O argumento collections é uma matriz de tamanho 0 ou contém um elemento nulo, ou pelo menos uma das coleções foi marcada como completa para adição.

InvalidOperationException

Pelo menos uma coleção subjacente não aceitou o item.

Confira também

• Coleções Thread-Safe
• Visão geral de BlockingCollection

TryAddToAny(BlockingCollection<T>[], T)

Origem:

BlockingCollection.cs

Tenta adicionar o item especificado a qualquer uma das instâncias BlockingCollection<T> especificadas.

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

Parâmetros

collections

BlockingCollection<T>[]

A matriz de coleções.

item

T

O item a ser adicionado a uma das coleções.

Retornos

Int32

O índice da coleção na matriz collections ao qual o item foi adicionado ou -1 caso o item não possa ser adicionado.

Exceções

ObjectDisposedException

Pelo menos uma das instâncias de BlockingCollection<T> foi descartada.

ArgumentNullException

O argumento collections é nulo.

ArgumentOutOfRangeException

A contagem de collections é maior que o tamanho máximo de 62 para STA e 63 para MTA.

ArgumentException

O argumento collections é uma matriz de tamanho 0 ou contém um elemento nulo, ou pelo menos uma das coleções foi marcada como completa para adição.

InvalidOperationException

Pelo menos uma coleção subjacente não aceitou o item.

Confira também

• Coleções Thread-Safe
• Visão geral de BlockingCollection