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

IReliableDictionary<TKey,TValue>.SetAsync 方法

定义

重载

SetAsync(ITransaction, TKey, TValue)

如果该键尚不存在,则将键/值对添加到可靠字典;如果键已存在,则更新可靠字典中的键/值对。

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

如果该键尚不存在,则将键/值对添加到可靠字典;如果键已存在,则更新可靠字典中的键/值对。

SetAsync(ITransaction, TKey, TValue)

如果该键尚不存在,则将键/值对添加到可靠字典;如果键已存在,则更新可靠字典中的键/值对。

public System.Threading.Tasks.Task SetAsync(Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue value);
abstract member SetAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value -> System.Threading.Tasks.Task
Public Function SetAsync (tx As ITransaction, key As TKey, value As TValue) As Task

参数

tx
ITransaction

要与此操作关联的事务。

key
TKey

应更新其值的键。

value
TValue

值,该值替换具有指定 key的 元素的值。

返回

表示异步更新操作的任务。

例外

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

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

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

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

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

适用于

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

如果该键尚不存在,则将键/值对添加到可靠字典;如果键已存在,则更新可靠字典中的键/值对。

public System.Threading.Tasks.Task SetAsync(Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue value, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);
abstract member SetAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function SetAsync (tx As ITransaction, key As TKey, value As TValue, timeout As TimeSpan, cancellationToken As CancellationToken) As Task

参数

tx
ITransaction

要与此操作关联的事务。

key
TKey

应更新其值的键。

value
TValue

值,该值替换具有指定 key的 元素的值。

timeout
TimeSpan

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

cancellationToken
CancellationToken

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

返回

表示异步更新操作的任务。

例外

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

timeout 为负数。

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

该操作已取消。

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

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

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

适用于