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