Partilhar via


BlockingCollection<T>.TryAddToAny Método

Definição

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
Origem:
BlockingCollection.cs
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

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

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

O argumento collections é nulo.

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.

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.

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

Confira também

Aplica-se a

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

Origem:
BlockingCollection.cs
Origem:
BlockingCollection.cs
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

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

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

O argumento collections é nulo.

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.

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.

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

Aplica-se a

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

Origem:
BlockingCollection.cs
Origem:
BlockingCollection.cs
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

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

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

O argumento collections é nulo.

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.

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.

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

Confira também

Aplica-se a

TryAddToAny(BlockingCollection<T>[], T)

Origem:
BlockingCollection.cs
Origem:
BlockingCollection.cs
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

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

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

O argumento collections é nulo.

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

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.

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

Confira também

Aplica-se a