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

IReliableDictionary3<TKey,TValue> 接口

定义

命名空间:

Microsoft.ServiceFabric.Data.Collections.Beta

程序集:

Microsoft.ServiceFabric.Data.Interfaces.V2.dll

包:

Microsoft.ServiceFabric.Data.Interfaces.V2 v6.1.1583

(Beta) 不用于生产 - API 将来可能会发生更改。 表示持久化和复制的键/值对的可靠集合。

public interface IReliableDictionary3<TKey,TValue> : Microsoft.ServiceFabric.Data.Collections.IReliableCollection<System.Collections.Generic.KeyValuePair<TKey,TValue>>, Microsoft.ServiceFabric.Data.Collections.IReliableDictionary<TKey,TValue>, Microsoft.ServiceFabric.Data.Collections.IReliableDictionary2<TKey,TValue> where TKey : IComparable<TKey>, IEquatable<TKey>

type IReliableDictionary3<'Key, 'Value (requires 'Key :> IComparable<'Key> and 'Key :> IEquatable<'Key>)> = interface
    interface IReliableDictionary2<'Key, 'Value (requires 'Key :> IComparable<'Key> and 'Key :> IEquatable<'Key>)>
    interface IReliableDictionary<'Key, 'Value (requires 'Key :> IComparable<'Key> and 'Key :> IEquatable<'Key>)>
    interface IReliableCollection<KeyValuePair<'Key, 'Value>>
    interface IReliableState

Public Interface IReliableDictionary3(Of TKey, TValue)
Implements IReliableCollection(Of KeyValuePair(Of TKey, TValue)), IReliableDictionary(Of TKey, TValue), IReliableDictionary2(Of TKey, TValue)

类型参数

TKey

可靠字典中键的类型。

TValue

可靠字典中值的类型。

实现

IReliableCollection<KeyValuePair<TKey,TValue>> IReliableDictionary<TKey,TValue> IReliableDictionary2<TKey,TValue> IReliableState

注解

存储在此字典中的键或值不得在字典上操作的上下文之外发生改变。 强烈建议将 和 TValue 设为TKey不可变，以避免意外的数据损坏。

事务是并发单位。 用户可以在任何给定时间点有多个未完成的事务，但对于给定事务，必须一次调用一个 API。 调用采用 ITransaction的任何异步 Reliable Collection 方法时，必须等待返回的 Task 完成，然后才能使用相同的事务调用另一个方法。

属性

Count	获取 中包含的 IReliableDictionary2<TKey,TValue>键值对的数目。 (继承自 IReliableDictionary2<TKey,TValue>)
Name	获取一个值，该值指示实例的唯一 IReliableState 名称。 (继承自 IReliableState)
RebuildNotificationAsyncCallback	在复制、还原或恢复期间重新生成可靠字典时调用的函数。 (继承自 IReliableDictionary<TKey,TValue>)

方法

AddAsync(ITransaction, TKey, TValue)	将指定的键/值对添加到可靠字典。 (继承自 IReliableDictionary<TKey,TValue>)
AddAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken)	将指定的键/值对添加到可靠字典。 (继承自 IReliableDictionary<TKey,TValue>)
AddOrUpdateAsync(ITransaction, TKey, Func<TKey,TValue>, Func<TKey,TValue,TValue>)	使用指定的函数将键/值对添加到可靠字典（如果该键尚不存在）或更新可靠字典中的键/值对（如果该键已存在）。 (继承自 IReliableDictionary<TKey,TValue>)
AddOrUpdateAsync(ITransaction, TKey, Func<TKey,TValue>, Func<TKey,TValue,TValue>, TimeSpan, CancellationToken)	使用指定的函数将键/值对添加到可靠字典（如果该键尚不存在）或更新可靠字典中的键/值对（如果该键已存在）。 (继承自 IReliableDictionary<TKey,TValue>)
AddOrUpdateAsync(ITransaction, TKey, TValue, Func<TKey,TValue,TValue>)	如果键尚不存在，请将键/值对添加到可靠字典中;如果键已存在，则使用指定的函数更新可靠字典中的键/值对。 (继承自 IReliableDictionary<TKey,TValue>)
AddOrUpdateAsync(ITransaction, TKey, TValue, Func<TKey,TValue,TValue>, TimeSpan, CancellationToken)	如果键尚不存在，请将键/值对添加到可靠字典中;如果键已存在，则使用指定的函数更新可靠字典中的键/值对。 (继承自 IReliableDictionary<TKey,TValue>)
ClearAsync()	从 IReliableCollection<T>中删除所有状态，包括复制状态和持久状态。 (继承自 IReliableCollection<T>)
ClearAsync(TimeSpan, CancellationToken)	从可靠字典中删除所有键和值。 (继承自 IReliableDictionary<TKey,TValue>)
ContainsKeyAsync(ITransaction, TKey)	确定可靠字典是否包含指定的键。 (继承自 IReliableDictionary<TKey,TValue>)
ContainsKeyAsync(ITransaction, TKey, LockMode)	确定可靠字典是否包含指定的键。 (继承自 IReliableDictionary<TKey,TValue>)
ContainsKeyAsync(ITransaction, TKey, LockMode, TimeSpan, CancellationToken)	确定可靠字典是否包含指定的键。 (继承自 IReliableDictionary<TKey,TValue>)
ContainsKeyAsync(ITransaction, TKey, TimeSpan, CancellationToken)	确定可靠字典是否包含指定的键。 (继承自 IReliableDictionary<TKey,TValue>)
CreateEnumerableAsync(ITransaction)	通过 IReliableDictionary<TKey,TValue>创建异步枚举器。 (继承自 IReliableDictionary<TKey,TValue>)
CreateEnumerableAsync(ITransaction, EnumerationMode)	通过 IReliableDictionary<TKey,TValue>创建异步枚举器。 (继承自 IReliableDictionary<TKey,TValue>)
CreateEnumerableAsync(ITransaction, Func<TKey,Boolean>, EnumerationMode)	通过 IReliableDictionary<TKey,TValue>创建异步枚举器。 (继承自 IReliableDictionary<TKey,TValue>)
CreateKeyEnumerableAsync(ITransaction)	通过 IReliableDictionary2<TKey,TValue> 创建异步枚举器以枚举键。 (继承自 IReliableDictionary2<TKey,TValue>)
CreateKeyEnumerableAsync(ITransaction, EnumerationMode)	通过 IReliableDictionary2<TKey,TValue> 创建异步枚举器以枚举键。 (继承自 IReliableDictionary2<TKey,TValue>)
CreateKeyEnumerableAsync(ITransaction, EnumerationMode, TimeSpan, CancellationToken)	通过 IReliableDictionary2<TKey,TValue> 创建异步枚举器以枚举键。 (继承自 IReliableDictionary2<TKey,TValue>)
CreateVersionedEnumerableAsync(ITransaction)	(Beta) 通过 IReliableDictionary<TKey,TValue>创建异步枚举器。
CreateVersionedEnumerableAsync(ITransaction, Func<TKey,Boolean>)	(Beta) 通过 IReliableDictionary<TKey,TValue>创建异步枚举器。
CreateVersionedEnumerableAsync(ITransaction, Func<TKey,Boolean>, TKey)	(Beta) 通过 IReliableDictionary<TKey,TValue>创建异步枚举器。
CreateVersionedEnumerableAsync(ITransaction, Func<TKey,Boolean>, TKey, TKey)	(Beta) 通过 IReliableDictionary<TKey,TValue>创建异步枚举器。
CreateVersionedEnumerableAsync(ITransaction, TKey)	(Beta) 通过 IReliableDictionary<TKey,TValue>创建异步枚举器。
CreateVersionedEnumerableAsync(ITransaction, TKey, TKey)	(Beta) 通过 IReliableDictionary<TKey,TValue>创建异步枚举器。
CreateVersionedKeyEnumerableAsync(ITransaction)	(Beta) 通过 IReliableDictionary3<TKey,TValue> 创建异步枚举器以枚举版本控制键。
CreateVersionedKeyEnumerableAsync(ITransaction, TKey)	(Beta) 通过 IReliableDictionary3<TKey,TValue> 创建异步枚举器以枚举版本控制键。
CreateVersionedKeyEnumerableAsync(ITransaction, TKey, TKey)	(Beta) 通过 IReliableDictionary3<TKey,TValue> 创建异步枚举器以枚举版本控制键。
GetCountAsync(ITransaction)	获取 IReliableCollection<T> 中包含的元素数。 (继承自 IReliableCollection<T>)
GetOrAddAsync(ITransaction, TKey, Func<TKey,TValue>)	使用指定的函数将键/值对添加到可靠字典（如果该键尚不存在）。 (继承自 IReliableDictionary<TKey,TValue>)
GetOrAddAsync(ITransaction, TKey, Func<TKey,TValue>, TimeSpan, CancellationToken)	使用指定的函数将键/值对添加到可靠字典（如果该键尚不存在）。 (继承自 IReliableDictionary<TKey,TValue>)
GetOrAddAsync(ITransaction, TKey, TValue)	如果该键尚不存在，则将键/值对添加到可靠字典中。 如果该键存在，则不会对值进行更新。 (继承自 IReliableDictionary<TKey,TValue>)
GetOrAddAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken)	如果该键尚不存在，则将键/值对添加到可靠字典中。 (继承自 IReliableDictionary<TKey,TValue>)
SetAsync(ITransaction, TKey, TValue)	如果该键尚不存在，则将键/值对添加到可靠字典;如果键已存在，则更新可靠字典中的键/值对。 (继承自 IReliableDictionary<TKey,TValue>)
SetAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken)	如果该键尚不存在，则将键/值对添加到可靠字典;如果键已存在，则更新可靠字典中的键/值对。 (继承自 IReliableDictionary<TKey,TValue>)
TryAddAsync(ITransaction, TKey, TValue)	尝试将指定的键和值添加到可靠字典。 (继承自 IReliableDictionary<TKey,TValue>)
TryAddAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken)	尝试将指定的键和值添加到可靠字典。 (继承自 IReliableDictionary<TKey,TValue>)
TryGetSequenceNumberAsync(ITransaction, TKey)	(Beta) 尝试从可靠字典中获取与指定键关联的序列号。
TryGetSequenceNumberAsync(ITransaction, TKey, LockMode)	(Beta) 尝试从可靠字典中获取与指定键关联的序列号。
TryGetSequenceNumberAsync(ITransaction, TKey, LockMode, TimeSpan, CancellationToken)	(Beta) 尝试从可靠字典中获取与指定键关联的序列号。
TryGetValueAsync(ITransaction, TKey)	尝试从可靠字典中获取与指定键关联的值。 (继承自 IReliableDictionary<TKey,TValue>)
TryGetValueAsync(ITransaction, TKey, LockMode)	尝试从可靠字典中获取与指定键关联的值。 (继承自 IReliableDictionary<TKey,TValue>)
TryGetValueAsync(ITransaction, TKey, LockMode, TimeSpan, CancellationToken)	尝试从可靠字典中获取与指定键关联的值。 (继承自 IReliableDictionary<TKey,TValue>)
TryGetValueAsync(ITransaction, TKey, TimeSpan, CancellationToken)	尝试从可靠字典中获取与指定键关联的值。 (继承自 IReliableDictionary<TKey,TValue>)
TryGetVersionedKeyValuePairAsync(ITransaction, TKey)	(Beta) 尝试从 Reliable Dictionary 获取与指定键关联的版本控制元素。
TryGetVersionedKeyValuePairAsync(ITransaction, TKey, LockMode)	(Beta) 尝试从 Reliable Dictionary 获取与指定键关联的版本控制元素。
TryGetVersionedKeyValuePairAsync(ITransaction, TKey, LockMode, TimeSpan, CancellationToken)	(Beta) 尝试从 Reliable Dictionary 获取与指定键关联的版本控制元素。
TryRemoveAsync(ITransaction, TKey)	尝试从可靠字典中删除具有指定键的值。 (继承自 IReliableDictionary<TKey,TValue>)
TryRemoveAsync(ITransaction, TKey, Int64)	(Beta) 尝试删除具有指定键的值（给定序列号匹配）。
TryRemoveAsync(ITransaction, TKey, Int64, TimeSpan, CancellationToken)	(Beta) 尝试删除具有指定键的值（给定序列号匹配）。
TryRemoveAsync(ITransaction, TKey, TimeSpan, CancellationToken)	尝试从可靠字典中删除具有指定键的值。 (继承自 IReliableDictionary<TKey,TValue>)
TryUpdateAsync(ITransaction, TKey, TValue, Int64)	(Beta) 尝试在序列号匹配的情况下更新指定键的值。
TryUpdateAsync(ITransaction, TKey, TValue, Int64, TimeSpan, CancellationToken)	(Beta) 尝试在序列号匹配的情况下更新指定键的值。
TryUpdateAsync(ITransaction, TKey, TValue, TValue)	将指定键的现有值与指定值进行比较，如果相等，则用第三个值更新该键。 (继承自 IReliableDictionary<TKey,TValue>)
TryUpdateAsync(ITransaction, TKey, TValue, TValue, TimeSpan, CancellationToken)	将指定键的现有值与指定值进行比较，如果相等，则用第三个值更新该键。 (继承自 IReliableDictionary<TKey,TValue>)

事件

DictionaryChanged

在可靠字典更改时发生。 例如，添加、更新或删除项。 (继承自 IReliableDictionary<TKey,TValue>)