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

IReliableDictionary<TKey,TValue> 接口

定义

命名空间:

Microsoft.ServiceFabric.Data.Collections

程序集:

Microsoft.ServiceFabric.Data.Interfaces.dll

包:

Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

表示持久化和复制的键/值对的可靠集合。

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

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

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

类型参数

TKey

Reliable Dictionary 中键的类型。

TValue

Reliable Dictionary 中值的类型。

派生

Microsoft.ServiceFabric.Data.Collections.Beta.IReliableDictionary3<TKey,TValue>

Microsoft.ServiceFabric.Data.Collections.IReliableDictionary2<TKey,TValue>

实现

IReliableCollection<KeyValuePair<TKey,TValue>> IReliableState

注解

存储在此字典中的键或值不得在字典上的操作上下文之外发生更改。 强烈建议使 和 TValue 不TKey可变，以避免意外的数据损坏。 有关常见缺陷，请参阅 此处 。

事务是并发单位。 用户可以在任何给定时间点有多个正在进行的事务，但对于给定的事务，必须一次调用一个 API。 调用采用 ITransaction的任何异步 Reliable Collection 方法时，必须等待返回的任务完成，然后再使用相同的事务调用另一个方法。 请参阅 此处的事务示例。

属性

Name	获取一个值，该值指示实例的唯一 IReliableState 名称。 (继承自 IReliableState)
RebuildNotificationAsyncCallback	在复制、还原或恢复期间重新生成 Reliable Dictionary 时调用的函数。

方法

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

事件

DictionaryChanged

在 Reliable Dictionary 更改时发生。 例如，添加、更新或删除项。