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

IReliableQueue<T>.TryPeekAsync 方法

定义

命名空间:

Microsoft.ServiceFabric.Data.Collections

程序集:

Microsoft.ServiceFabric.Data.Interfaces.dll

包:

Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

重载

TryPeekAsync(ITransaction)	尝试从可靠队列的开头返回对象，而不将其删除。
TryPeekAsync(ITransaction, LockMode)	尝试从可靠队列的开头返回对象，而不将其删除。
TryPeekAsync(ITransaction, TimeSpan, CancellationToken)	尝试从可靠队列的开头返回对象，而不将其删除。
TryPeekAsync(ITransaction, LockMode, TimeSpan, CancellationToken)	尝试从可靠队列的开头返回对象，而不将其删除。

TryPeekAsync(ITransaction)

尝试从可靠队列的开头返回对象，而不将其删除。

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

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

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

参数

tx

ITransaction

要与此操作关联的事务。

返回

Task<ConditionalValue<T>>

表示异步速览操作的任务。 任务结果是一个元组，指示是否在队列的开头找到对象，如果是，则为 对象。

例外

ArgumentNullException

tx 为 null。

TimeoutException

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

FabricNotReadableException

异常指示 目前无法提供读取。 可以在所有 中引发。 在 中 引发它的一个示例是 丢失 。 在 中 引发的一个示例是，可靠队列的状态尚不一致。

TransactionFaultedException

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

InvalidOperationException

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

TryPeekAsync(ITransaction, LockMode)

尝试从可靠队列的开头返回对象，而不将其删除。

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<T>> TryPeekAsync (Microsoft.ServiceFabric.Data.ITransaction tx, Microsoft.ServiceFabric.Data.Collections.LockMode lockMode);

abstract member TryPeekAsync : Microsoft.ServiceFabric.Data.ITransaction * Microsoft.ServiceFabric.Data.Collections.LockMode -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<'T>>

Public Function TryPeekAsync (tx As ITransaction, lockMode As LockMode) As Task(Of ConditionalValue(Of T))

参数

tx

ITransaction

要与此操作关联的事务。

lockMode

LockMode

用于此读取操作的锁定类型。

返回

Task<ConditionalValue<T>>

表示异步速览操作的任务。 任务结果是一个元组，指示是否在队列的开头找到对象，如果是，则为 对象。

例外

ArgumentNullException

tx 为 null。

TimeoutException

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

FabricNotReadableException

异常指示 目前无法提供读取。 可以在所有 中引发。 在 中 引发它的一个示例是 丢失 。 在 中 引发的一个示例是，可靠队列的状态尚不一致。

TransactionFaultedException

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

InvalidOperationException

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

TryPeekAsync(ITransaction, TimeSpan, CancellationToken)

尝试从可靠队列的开头返回对象，而不将其删除。

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

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

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

参数

tx

ITransaction

要与此操作关联的事务。

timeout

TimeSpan

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

cancellationToken

CancellationToken

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

返回

Task<ConditionalValue<T>>

表示异步速览操作的任务。 任务结果是一个元组，指示是否在队列的开头找到对象，如果是，则为 对象。

例外

ArgumentNullException

tx 为 null。

ArgumentException

timeout 为负数。

TimeoutException

操作未能在给定的超时时间内完成。

OperationCanceledException

该操作已取消。

FabricNotReadableException

异常指示 目前无法提供读取。 可以在所有 中引发。 在 中 引发它的一个示例是 丢失 。 在 中 引发的一个示例是，可靠队列的状态尚不一致。

TransactionFaultedException

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

InvalidOperationException

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

TryPeekAsync(ITransaction, LockMode, TimeSpan, CancellationToken)

尝试从可靠队列的开头返回对象，而不将其删除。

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

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

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

参数

tx

ITransaction

要与此操作关联的事务。

lockMode

LockMode

用于此读取操作的锁定类型。

timeout

TimeSpan

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

cancellationToken

CancellationToken

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

返回

Task<ConditionalValue<T>>

表示异步速览操作的任务。 任务结果是一个元组，指示是否在队列的开头找到对象，如果是，则为 对象。

例外

ArgumentNullException

tx 为 null。

ArgumentException

timeout 为负数。

TimeoutException

操作未能在给定的超时时间内完成。

OperationCanceledException

该操作已取消。

FabricNotReadableException

异常指示 目前无法提供读取。 可以在所有 中引发。 在 中 引发它的一个示例是 丢失 。 在 中 引发的一个示例是，可靠队列的状态尚不一致。

TransactionFaultedException

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

InvalidOperationException

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