Share via


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

IReliableDictionary<TKey,TValue>.TryUpdateAsync 方法

定义

重载

TryUpdateAsync(ITransaction, TKey, TValue, TValue)

将指定键的现有值与指定值进行比较,如果相等,则用第三个值更新该键。

TryUpdateAsync(ITransaction, TKey, TValue, TValue, TimeSpan, CancellationToken)

将指定键的现有值与指定值进行比较,如果相等,则用第三个值更新该键。

TryUpdateAsync(ITransaction, TKey, TValue, TValue)

将指定键的现有值与指定值进行比较,如果相等,则用第三个值更新该键。

public System.Threading.Tasks.Task<bool> TryUpdateAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue newValue, TValue comparisonValue);
abstract member TryUpdateAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value * 'Value -> System.Threading.Tasks.Task<bool>
Public Function TryUpdateAsync (tx As ITransaction, key As TKey, newValue As TValue, comparisonValue As TValue) As Task(Of Boolean)

参数

tx
ITransaction

要与此操作关联的事务。

key
TKey

其值与 comparisonValue 进行比较并可能被替换的键。

newValue
TValue

一个值,当比较结果相等时,将替换具有指定 key 的元素的值。

comparisonValue
TValue

与具有指定 key的 元素的值进行比较的值。

返回

表示异步更新操作的任务。 任务结果指示对象是否已更新。

例外

tx 为 null,或 key 为 null 或无法序列化。

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

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

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

指示可靠字典已关闭或删除。

适用于

TryUpdateAsync(ITransaction, TKey, TValue, TValue, TimeSpan, CancellationToken)

将指定键的现有值与指定值进行比较,如果相等,则用第三个值更新该键。

public System.Threading.Tasks.Task<bool> TryUpdateAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue newValue, TValue comparisonValue, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);
abstract member TryUpdateAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value * 'Value * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Function TryUpdateAsync (tx As ITransaction, key As TKey, newValue As TValue, comparisonValue As TValue, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of Boolean)

参数

tx
ITransaction

要与此操作关联的事务。

key
TKey

其值与 comparisonValue 进行比较并可能被替换的键。

newValue
TValue

一个值,当比较结果相等时,将替换具有指定 key 的元素的值。

comparisonValue
TValue

与具有指定 key的 元素的值进行比较的值。

timeout
TimeSpan

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

cancellationToken
CancellationToken

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

返回

表示异步更新操作的任务。 任务结果指示对象是否已更新。

例外

tx 为 null,或 key 为 null 或无法序列化。

timeout 为负数。

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

该操作已取消。

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

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

指示可靠字典已关闭或删除。

适用于