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

IReliableDictionary<TKey,TValue>.CreateEnumerableAsync 方法

定义

命名空间:

Microsoft.ServiceFabric.Data.Collections

程序集:

Microsoft.ServiceFabric.Data.Interfaces.dll

包:

Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

重载

CreateEnumerableAsync(ITransaction)	通过 IReliableDictionary<TKey,TValue>创建异步枚举器。
CreateEnumerableAsync(ITransaction, EnumerationMode)	通过 IReliableDictionary<TKey,TValue>创建异步枚举器。
CreateEnumerableAsync(ITransaction, Func<TKey,Boolean>, EnumerationMode)	通过 IReliableDictionary<TKey,TValue>创建异步枚举器。

CreateEnumerableAsync(ITransaction)

通过 IReliableDictionary<TKey,TValue>创建异步枚举器。

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.IAsyncEnumerable<System.Collections.Generic.KeyValuePair<TKey,TValue>>> CreateEnumerableAsync (Microsoft.ServiceFabric.Data.ITransaction txn);

abstract member CreateEnumerableAsync : Microsoft.ServiceFabric.Data.ITransaction -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.IAsyncEnumerable<System.Collections.Generic.KeyValuePair<'Key, 'Value>>>

Public Function CreateEnumerableAsync (txn As ITransaction) As Task(Of IAsyncEnumerable(Of KeyValuePair(Of TKey, TValue)))

参数

txn

ITransaction

要与此操作关联的事务。

返回

Task<IAsyncEnumerable<KeyValuePair<TKey,TValue>>>

表示异步创建可枚举操作的任务。 任务结果是可靠字典的枚举器。

例外

FabricNotReadableException

指示 IReliableDictionary 目前无法提供读取。 可以在所有 ReplicaRole中引发此异常。 在 角色中 Primary 可能引发该操作的一个原因是 丢失 ReadStatus了 。 该角色中 ActiveSecondary 可能会引发该角色的一个原因是可靠集合的状态尚不一致。

TransactionFaultedException

事务在内部由系统出错。 对新事务重试操作

InvalidOperationException

当方法调用对对象的当前状态无效时引发。 例如，使用的事务已终止：用户已提交或中止。 如果引发此异常，则很可能使用事务的服务代码中存在 bug。

FabricObjectClosedException

指示关闭或删除可靠字典。

注解

返回的枚举器可以安全地与可靠字典的读取和写入同时使用。 它表示快照一致的视图。 请注意， GetAsyncEnumerator() 需要在返回的 IAsyncEnumerable 上调用 才能枚举。 可在此处查看示例用法。

CreateEnumerableAsync(ITransaction, EnumerationMode)

通过 IReliableDictionary<TKey,TValue>创建异步枚举器。

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.IAsyncEnumerable<System.Collections.Generic.KeyValuePair<TKey,TValue>>> CreateEnumerableAsync (Microsoft.ServiceFabric.Data.ITransaction txn, Microsoft.ServiceFabric.Data.Collections.EnumerationMode enumerationMode);

abstract member CreateEnumerableAsync : Microsoft.ServiceFabric.Data.ITransaction * Microsoft.ServiceFabric.Data.Collections.EnumerationMode -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.IAsyncEnumerable<System.Collections.Generic.KeyValuePair<'Key, 'Value>>>

Public Function CreateEnumerableAsync (txn As ITransaction, enumerationMode As EnumerationMode) As Task(Of IAsyncEnumerable(Of KeyValuePair(Of TKey, TValue)))

参数

txn

ITransaction

要与此操作关联的事务。

enumerationMode

EnumerationMode

要使用的枚举模式。 默认值为 Unordered。 有序枚举仅升序。

返回

Task<IAsyncEnumerable<KeyValuePair<TKey,TValue>>>

表示异步创建可枚举操作的任务。 任务结果是可靠字典的枚举器。

例外

FabricNotReadableException

指示 IReliableDictionary 目前无法提供读取。 可以在所有 ReplicaRole中引发此异常。 在 角色中 Primary 可能引发该操作的一个原因是 丢失 ReadStatus了 。 该角色中 ActiveSecondary 可能会引发该角色的一个原因是可靠集合的状态尚不一致。

TransactionFaultedException

事务在内部由系统出错。 对新事务重试操作

InvalidOperationException

当方法调用对对象的当前状态无效时引发。 例如，使用的事务已终止：用户已提交或中止。 如果引发此异常，则很可能使用事务的服务代码中存在 bug。

FabricObjectClosedException

指示关闭或删除可靠字典。

注解

返回的枚举器可以安全地与可靠字典的读取和写入同时使用。 它表示快照一致的视图。 请注意， GetAsyncEnumerator() 需要在返回的 IAsyncEnumerable 上调用 才能枚举。 可在此处查看示例用法。

CreateEnumerableAsync(ITransaction, Func<TKey,Boolean>, EnumerationMode)

通过 IReliableDictionary<TKey,TValue>创建异步枚举器。

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.IAsyncEnumerable<System.Collections.Generic.KeyValuePair<TKey,TValue>>> CreateEnumerableAsync (Microsoft.ServiceFabric.Data.ITransaction txn, Func<TKey,bool> filter, Microsoft.ServiceFabric.Data.Collections.EnumerationMode enumerationMode);

abstract member CreateEnumerableAsync : Microsoft.ServiceFabric.Data.ITransaction * Func<'Key, bool (requires 'Key :> IComparable<'Key> and 'Key :> IEquatable<'Key>)> * Microsoft.ServiceFabric.Data.Collections.EnumerationMode -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.IAsyncEnumerable<System.Collections.Generic.KeyValuePair<'Key, 'Value>>>

Public Function CreateEnumerableAsync (txn As ITransaction, filter As Func(Of TKey, Boolean), enumerationMode As EnumerationMode) As Task(Of IAsyncEnumerable(Of KeyValuePair(Of TKey, TValue)))

参数

txn

ITransaction

要与此操作关联的事务。

filter

Func<TKey,Boolean>

根据键筛选要包含在枚举中的键值对的谓词。

enumerationMode

EnumerationMode

要使用的枚举模式。 默认值为 Unordered。 有序枚举仅升序。

返回

Task<IAsyncEnumerable<KeyValuePair<TKey,TValue>>>

表示异步创建可枚举操作的任务。 任务结果是可靠字典的枚举器。

例外

FabricNotReadableException

指示 IReliableDictionary 目前无法提供读取。 可以在所有 ReplicaRole中引发此异常。 在 角色中 Primary 可能引发该操作的一个原因是 丢失 ReadStatus了 。 该角色中 ActiveSecondary 可能会引发该角色的一个原因是可靠集合的状态尚不一致。

TransactionFaultedException

事务在内部由系统出错。 对新事务重试操作

InvalidOperationException

当方法调用对对象的当前状态无效时引发。 例如，使用的事务已终止：用户已提交或中止。 如果引发此异常，则很可能使用事务的服务代码中存在 bug。

FabricObjectClosedException

指示关闭或删除可靠字典。

注解

返回的枚举器可以安全地与可靠字典的读取和写入同时使用。 它表示快照一致的视图。 请注意， GetAsyncEnumerator() 需要在返回的 IAsyncEnumerable 上调用 才能枚举。 可在此处查看示例用法。