你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
IReliableDictionary<TKey,TValue>.AddAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
AddAsync(ITransaction, TKey, TValue) |
将指定的键/值对添加到 Reliable Dictionary。 |
AddAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken) |
将指定的键/值对添加到 Reliable Dictionary。 |
AddAsync(ITransaction, TKey, TValue)
将指定的键/值对添加到 Reliable Dictionary。
public System.Threading.Tasks.Task AddAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue value);
abstract member AddAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value -> System.Threading.Tasks.Task
Public Function AddAsync (tx As ITransaction, key As TKey, value As TValue) As Task
参数
- tx
- ITransaction
要与此操作关联的事务。
- key
- TKey
要添加的键。
- value
- TValue
要添加的值。 对于引用类型,该值可以为 null。
返回
表示异步添加操作的任务。
例外
tx
为 null,或 key
为 null 或无法序列化。
可靠字典中已存在具有相同键的值。
操作在默认超时内无法完成。
事务在内部由系统出错。 对新事务重试操作
当方法调用对对象的当前状态无效时引发。 例如,使用的事务已终止:用户已提交或中止。 如果引发此异常,则很可能使用事务的服务代码中存在 bug。
指示可靠字典已关闭或删除。
适用于
AddAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken)
将指定的键/值对添加到 Reliable Dictionary。
public System.Threading.Tasks.Task AddAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue value, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);
abstract member AddAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function AddAsync (tx As ITransaction, key As TKey, value As TValue, timeout As TimeSpan, cancellationToken As CancellationToken) As Task
参数
- tx
- ITransaction
要与此操作关联的事务。
- key
- TKey
要添加的键。
- value
- TValue
要添加的值。 对于引用类型,该值可以为 null。
- timeout
- TimeSpan
在引发 TimeoutException 之前等待操作完成的时间量。 主要用于防止死锁。 默认值为 4 秒。
- cancellationToken
- CancellationToken
要监视取消请求的标记。 默认值为 None。
返回
表示异步添加操作的任务。
例外
tx
为 null,或 key
为 null 或无法序列化。
可靠字典中已存在具有相同键的值,或 timeout
为负值。
操作在给定的超时内未能完成。
该操作已取消。
事务在内部由系统出错。 对新事务重试操作
当方法调用对对象的当前状态无效时引发。 例如,使用的事务已终止:用户已提交或中止。 如果引发此异常,则很可能使用事务的服务代码中存在 bug。
指示可靠字典已关闭或删除。