你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
IReliableDictionary<TKey,TValue>.SetAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
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。
指示关闭或删除可靠字典。