Partager via


IReliableDictionary3<TKey,TValue>.TryGetVersionedKeyValuePairAsync Méthode

Définition

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

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

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

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

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

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.

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

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.

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

S’applique à

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

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

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

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

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

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.

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

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.

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

S’applique à

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

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

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

timeout est un nombre négatif.

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

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

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.

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

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.

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

S’applique à