IReliableDictionary3<TKey,TValue>.TryGetVersionedKeyValuePairAsync Méthode

Définition

Espace de noms:

Microsoft.ServiceFabric.Data.Collections.Beta

Assembly:

Microsoft.ServiceFabric.Data.Interfaces.V2.dll

Paquet:

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

Surcharges

TryGetVersionedKeyValuePairAsync(ITransaction, TKey)	(Bêta) Tente d’obtenir l’élément versionné associé à la clé spécifiée à partir du dictionnaire fiable.
TryGetVersionedKeyValuePairAsync(ITransaction, TKey, LockMode)	(Bêta) Tente d’obtenir l’élément versionné associé à la clé spécifiée à partir du dictionnaire fiable.
TryGetVersionedKeyValuePairAsync(ITransaction, TKey, LockMode, TimeSpan, CancellationToken)	(Bêta) Tente d’obtenir l’élément versionné associé à la clé spécifiée à partir du dictionnaire fiable.

TryGetVersionedKeyValuePairAsync(ITransaction, TKey)

(Bêta) Tente d’obtenir l’élément versionné associé à la clé spécifiée à partir du dictionnaire fiable.

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<TKey,TValue>>> TryGetVersionedKeyValuePairAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key);

abstract member TryGetVersionedKeyValuePairAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<'Key, 'Value>>>

Public Function TryGetVersionedKeyValuePairAsync (tx As ITransaction, key As TKey) As Task(Of ConditionalValue(Of VersionedKeyValuePair(Of TKey, TValue)))

Paramètres

tx

ITransaction

Transaction à laquelle associer cette opération.

key

TKey

Clé de l’élément versionné à obtenir.

Retours

Task<ConditionalValue<VersionedKeyValuePair<TKey,TValue>>>

Tâche qui représente l'opération de lecture asynchrone. Le résultat de la tâche est un tuple indiquant si la clé a été trouvée dans le dictionnaire fiable et, si elle est trouvée, la valeur et le numéro de séquence.

Exceptions

ArgumentNullException

tx est null, ou key est null ou ne peut pas être sérialisé.

TimeoutException

L’opération n’a pas pu se terminer dans le délai d’expiration donné.

OperationCanceledException

L'opération a été annulée.

FabricNotReadableException

Indique que i ReliableDictionary ne peut pas traiter les lectures pour le moment. Cette exception peut être levée dans tous les ReplicaRoles. L’une des raisons pour lesquelles elle peut être levée dans le rôle est la Primary perte de ReadStatus. L’une des raisons pour lesquelles elle peut être levée dans le rôle est que l’état ActiveSecondary de Reliable Collection n’est pas encore cohérent.

TransactionFaultedException

La transaction a été défaillante en interne par le système. Réessayez l’opération sur une nouvelle transaction

InvalidOperationException

Levée lorsqu’un appel de méthode n’est pas valide pour l’état actuel de l’objet. Par exemple, la transaction utilisée est déjà terminée : validée ou abandonnée par l’utilisateur. Si cette exception est levée, il est très probable qu’il y ait un bogue dans le code de service de l’utilisation des transactions.

FabricObjectClosedException

Indique que le dictionnaire fiable est fermé ou supprimé.

TryGetVersionedKeyValuePairAsync(ITransaction, TKey, LockMode)

(Bêta) Tente d’obtenir l’élément versionné associé à la clé spécifiée à partir du dictionnaire fiable.

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<TKey,TValue>>> TryGetVersionedKeyValuePairAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Microsoft.ServiceFabric.Data.Collections.LockMode lockMode);

abstract member TryGetVersionedKeyValuePairAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Microsoft.ServiceFabric.Data.Collections.LockMode -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<'Key, 'Value>>>

Public Function TryGetVersionedKeyValuePairAsync (tx As ITransaction, key As TKey, lockMode As LockMode) As Task(Of ConditionalValue(Of VersionedKeyValuePair(Of TKey, TValue)))

Paramètres

tx

ITransaction

Transaction à laquelle associer cette opération.

key

TKey

Clé de l’élément versionné à obtenir.

lockMode

LockMode

Type de verrouillage à utiliser pour cette opération de lecture.

Retours

Task<ConditionalValue<VersionedKeyValuePair<TKey,TValue>>>

Tâche qui représente l'opération de lecture asynchrone. Le résultat de la tâche est un tuple indiquant si la clé a été trouvée dans le dictionnaire fiable et, si elle est trouvée, la valeur et le numéro de séquence.

Exceptions

ArgumentNullException

tx est null, ou key est null ou ne peut pas être sérialisé.

TimeoutException

L’opération n’a pas pu se terminer dans le délai d’expiration donné.

OperationCanceledException

L'opération a été annulée.

FabricNotReadableException

Indique que i ReliableDictionary ne peut pas traiter les lectures pour le moment. Cette exception peut être levée dans tous les ReplicaRoles. L’une des raisons pour lesquelles elle peut être levée dans le rôle est la Primary perte de ReadStatus. L’une des raisons pour lesquelles elle peut être levée dans le rôle est que l’état ActiveSecondary de Reliable Collection n’est pas encore cohérent.

TransactionFaultedException

La transaction a été défaillante en interne par le système. Réessayez l’opération sur une nouvelle transaction

InvalidOperationException

Levée lorsqu’un appel de méthode n’est pas valide pour l’état actuel de l’objet. Par exemple, la transaction utilisée est déjà terminée : validée ou abandonnée par l’utilisateur. Si cette exception est levée, il est très probable qu’il y ait un bogue dans le code de service de l’utilisation des transactions.

FabricObjectClosedException

Indique que le dictionnaire fiable est fermé ou supprimé.

TryGetVersionedKeyValuePairAsync(ITransaction, TKey, LockMode, TimeSpan, CancellationToken)

(Bêta) Tente d’obtenir l’élément versionné associé à la clé spécifiée à partir du dictionnaire fiable.

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<TKey,TValue>>> TryGetVersionedKeyValuePairAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Microsoft.ServiceFabric.Data.Collections.LockMode lockMode, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

abstract member TryGetVersionedKeyValuePairAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Microsoft.ServiceFabric.Data.Collections.LockMode * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<'Key, 'Value>>>

Public Function TryGetVersionedKeyValuePairAsync (tx As ITransaction, key As TKey, lockMode As LockMode, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ConditionalValue(Of VersionedKeyValuePair(Of TKey, TValue)))

Paramètres

tx

ITransaction

Transaction à laquelle associer cette opération.

key

TKey

Clé de l’élément versionné à obtenir.

lockMode

LockMode

Type de verrouillage à utiliser pour cette opération de lecture.

timeout

TimeSpan

Délai d’attente de la fin de l’opération avant de lever une exception TimeoutException. Principalement utilisé pour éviter les interblocages. La valeur par défaut est de 4 secondes.

cancellationToken

CancellationToken

Jeton pour surveiller les requêtes d'annulation. La valeur par défaut est Aucun.

Retours

Task<ConditionalValue<VersionedKeyValuePair<TKey,TValue>>>

Tâche qui représente l'opération de lecture asynchrone. Le résultat de la tâche est un tuple indiquant si la clé a été trouvée dans le dictionnaire fiable et, si elle est trouvée, la valeur et le numéro de séquence.

Exceptions

ArgumentNullException

tx est null, ou key est null ou ne peut pas être sérialisé.

ArgumentException

timeout est un nombre négatif.

TimeoutException

L’opération n’a pas pu se terminer dans le délai d’expiration donné.

OperationCanceledException

L'opération a été annulée.

FabricNotReadableException

Indique que i ReliableDictionary ne peut pas traiter les lectures pour le moment. Cette exception peut être levée dans tous les ReplicaRoles. L’une des raisons pour lesquelles elle peut être levée dans le rôle est la Primary perte de ReadStatus. L’une des raisons pour lesquelles elle peut être levée dans le rôle est que l’état ActiveSecondary de Reliable Collection n’est pas encore cohérent.

TransactionFaultedException

La transaction a été défaillante en interne par le système. Réessayez l’opération sur une nouvelle transaction

InvalidOperationException

Levée lorsqu’un appel de méthode n’est pas valide pour l’état actuel de l’objet. Par exemple, la transaction utilisée est déjà terminée : validée ou abandonnée par l’utilisateur. Si cette exception est levée, il est très probable qu’il y ait un bogue dans le code de service de l’utilisation des transactions.

FabricObjectClosedException

Indique que le dictionnaire fiable est fermé ou supprimé.