IReliableQueue<T>.TryDequeueAsync Método

Definição

Namespace:

Microsoft.ServiceFabric.Data.Collections

Assembly:

Microsoft.ServiceFabric.Data.Interfaces.dll

Pacote:

Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

Sobrecargas

TryDequeueAsync(ITransaction)	Tenta remover e retornar o objeto no início da fila confiável.
TryDequeueAsync(ITransaction, TimeSpan, CancellationToken)	Tenta remover e retornar o objeto no início da fila confiável.

TryDequeueAsync(ITransaction)

Tenta remover e retornar o objeto no início da fila confiável.

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<T>> TryDequeueAsync (Microsoft.ServiceFabric.Data.ITransaction tx);

abstract member TryDequeueAsync : Microsoft.ServiceFabric.Data.ITransaction -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<'T>>

Public Function TryDequeueAsync (tx As ITransaction) As Task(Of ConditionalValue(Of T))

Parâmetros

tx

ITransaction

Transação à qual associar essa operação.

Retornos

Task<ConditionalValue<T>>

Tarefa que representa a operação assíncrona de remoção de fila. O resultado da tarefa é uma tupla que indica se um objeto foi removido e, em caso afirmativo, o objeto .

Exceções

ArgumentNullException

tx é nulo.

TimeoutException

Falha ao concluir a operação dentro do tempo limite padrão.

FabricNotPrimaryException

A exceção que é gerada quando o não está em .

TransactionFaultedException

A transação foi falha interna pelo sistema. Repetir a operação em uma nova transação

InvalidOperationException

Gerada quando uma chamada de método é inválida para o estado atual do objeto. Por exemplo, a transação usada já foi encerrada: confirmada ou anulada pelo usuário. Se essa exceção for gerada, é altamente provável que haja um bug no código de serviço do uso de transações.

Comentários

Se uma exceção retriável for gerada por esse método, é recomendável descartar a transação tx e tentar novamente com uma nova transação.

TryDequeueAsync(ITransaction, TimeSpan, CancellationToken)

Tenta remover e retornar o objeto no início da fila confiável.

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<T>> TryDequeueAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

abstract member TryDequeueAsync : Microsoft.ServiceFabric.Data.ITransaction * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<'T>>

Public Function TryDequeueAsync (tx As ITransaction, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ConditionalValue(Of T))

Parâmetros

tx

ITransaction

Transação à qual associar essa operação.

timeout

TimeSpan

A quantidade de tempo para aguardar a conclusão da operação antes de lançar um TimeoutException. Usado principalmente para evitar deadlocks. O padrão é 4 segundos.

cancellationToken

CancellationToken

O token a se monitorar para solicitações de cancelamento. A opção padrão é Nenhum.

Retornos

Task<ConditionalValue<T>>

Tarefa que representa a operação assíncrona de remoção de fila. O resultado da tarefa é uma tupla que indica se um objeto foi removido e, em caso afirmativo, o objeto .

Exceções

ArgumentNullException

tx é nulo.

ArgumentException

timeout é negativo.

TimeoutException

Falha ao concluir a operação dentro do tempo limite especificado.

OperationCanceledException

A operação foi cancelada.

FabricNotPrimaryException

A exceção que é gerada quando o não está em .

TransactionFaultedException

A transação foi falha interna pelo sistema. Repetir a operação em uma nova transação

InvalidOperationException

Gerada quando uma chamada de método é inválida para o estado atual do objeto. Por exemplo, a transação usada já foi encerrada: confirmada ou anulada pelo usuário. Se essa exceção for gerada, é altamente provável que haja um bug no código de serviço do uso de transações.

Comentários

Se uma exceção retriável for gerada por esse método, é recomendável descartar a transação tx e tentar novamente com uma nova transação.