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

IReliableQueue<T>.EnqueueAsync 方法

参考

定义

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

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

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

重要

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

重载

EnqueueAsync(ITransaction, T)	将对象添加到可靠队列的末尾。
EnqueueAsync(ITransaction, T, TimeSpan, CancellationToken)	将对象添加到可靠队列的末尾。

EnqueueAsync(ITransaction, T)

将对象添加到可靠队列的末尾。

public System.Threading.Tasks.Task EnqueueAsync (Microsoft.ServiceFabric.Data.ITransaction tx, T item);

abstract member EnqueueAsync : Microsoft.ServiceFabric.Data.ITransaction * 'T -> System.Threading.Tasks.Task

Public Function EnqueueAsync (tx As ITransaction, item As T) As Task

参数

tx: ITransaction

要与此操作关联的事务。

item: T

要添加到队列末尾的对象。对于引用类型，该值可以为 null。

Task

表示异步排队操作的任务。

例外

ArgumentNullException

tx 为 null。

TimeoutException

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

FabricNotPrimaryException

当不在中时引发的异常。

TransactionFaultedException

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

InvalidOperationException

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

注解

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

适用于

EnqueueAsync(ITransaction, T, TimeSpan, CancellationToken)

将对象添加到可靠队列的末尾。

public System.Threading.Tasks.Task EnqueueAsync (Microsoft.ServiceFabric.Data.ITransaction tx, T item, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

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

Public Function EnqueueAsync (tx As ITransaction, item As T, timeout As TimeSpan, cancellationToken As CancellationToken) As Task

参数

tx: ITransaction

要与此操作关联的事务。

item: T

要添加到队列末尾的对象。对于引用类型，该值可以为 null。

timeout: TimeSpan

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

cancellationToken: CancellationToken

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