你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

IReliableQueue<T>.TryDequeueAsync 方法

参考

定义

命名空间:: Microsoft.ServiceFabric.Data.Collections

程序集:: Microsoft.ServiceFabric.Data.Interfaces.dll

包:: Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

TryDequeueAsync(ITransaction)	尝试删除并返回可靠队列开头的对象。
TryDequeueAsync(ITransaction, TimeSpan, CancellationToken)	尝试删除并返回可靠队列开头的对象。

TryDequeueAsync(ITransaction)

尝试删除并返回可靠队列开头的对象。

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))

参数

tx: ITransaction

要与此操作关联的事务。

Task<ConditionalValue<T>>

表示异步取消排队操作的任务。任务结果是一个元组，指示是否删除了对象，如果是，则为对象。

例外

ArgumentNullException

tx 为 null。

TimeoutException

操作在默认超时时间内无法完成。

FabricNotPrimaryException

当不在中时引发的异常。

TransactionFaultedException

事务在内部由系统出错。对新事务重试操作

InvalidOperationException

当方法调用对对象的当前状态无效时引发。例如，使用的事务已终止：用户已提交或中止。如果引发此异常，则很可能使用事务的服务代码中存在 bug。

注解

如果此方法引发了可重试的异常，建议释放该事务 tx ，并使用新事务重试。

适用于

TryDequeueAsync(ITransaction, TimeSpan, CancellationToken)

尝试删除并返回可靠队列开头的对象。

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))

参数

tx: ITransaction

要与此操作关联的事务。

timeout: TimeSpan

在引发 TimeoutException 之前等待操作完成的时间量。主要用于防止死锁。默认值为 4 秒。

cancellationToken: CancellationToken

要监视取消请求的标记。默认值为 None。