DbDataReader.NextResultAsync Méthode

Définition

Avance le lecteur de manière asynchrone jusqu’au résultat suivant lors de la lecture des résultats d’un lot d’instructions.

Surcharges

NextResultAsync()

Avance le lecteur de manière asynchrone jusqu’au résultat suivant lors de la lecture des résultats d’un lot d’instructions.

NextResultAsync(CancellationToken)

Avance le lecteur de manière asynchrone jusqu’au résultat suivant lors de la lecture des résultats d’un lot d’instructions.

Remarques

Pour plus d’informations sur la programmation asynchrone, consultez Programmation asynchrone.

NextResultAsync()

Avance le lecteur de manière asynchrone jusqu’au résultat suivant lors de la lecture des résultats d’un lot d’instructions.

public:
 System::Threading::Tasks::Task<bool> ^ NextResultAsync();
public System.Threading.Tasks.Task<bool> NextResultAsync ();
member this.NextResultAsync : unit -> System.Threading.Tasks.Task<bool>
Public Function NextResultAsync () As Task(Of Boolean)

Retours

Tâche dont la propriété Result est true s’il y a plus de jeux de résultats ou false dans le cas contraire.

Exceptions

Erreur qui s'est produite lors de l'exécution du texte de la commande.

Remarques

L’implémentation par défaut de cette méthode asynchrone appelle son équivalent synchrone et retourne une tâche terminée, ce qui bloque potentiellement le thread appelant.

Les fournisseurs de données qui prennent en charge la programmation asynchrone doivent remplacer l’implémentation par défaut à l’aide d’opérations d’E/S asynchrones.

Les autres méthodes et propriétés de l'objet DbDataReader ne doivent pas être appelées tant que la tâche retournée n'est pas terminée. Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par NextResult().

Voir aussi

S’applique à

NextResultAsync(CancellationToken)

Avance le lecteur de manière asynchrone jusqu’au résultat suivant lors de la lecture des résultats d’un lot d’instructions.

public:
 virtual System::Threading::Tasks::Task<bool> ^ NextResultAsync(System::Threading::CancellationToken cancellationToken);
public virtual System.Threading.Tasks.Task<bool> NextResultAsync (System.Threading.CancellationToken cancellationToken);
abstract member NextResultAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.NextResultAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Overridable Function NextResultAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

Paramètres

cancellationToken
CancellationToken

Instruction d'annulation.

Retours

Task<TResult> dont la propriété Result est true s’il y a plus de jeux de résultats ou false dans le cas contraire.

Exceptions

Erreur qui s'est produite lors de l'exécution du texte de la commande.

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

L’implémentation par défaut de cette méthode asynchrone appelle son équivalent synchrone et retourne une tâche terminée, ce qui bloque potentiellement le thread appelant. L’implémentation par défaut retourne également une tâche annulée si un jeton d’annulation déjà annulé est passé.

Les fournisseurs de données qui prennent en charge la programmation asynchrone doivent remplacer l’implémentation par défaut à l’aide d’opérations d’E/S asynchrones.

Cette méthode accepte un jeton d'annulation qui peut être utilisé pour demander l'annulation de l'opération plus tôt que prévu. Les implémentations peuvent ignorer cette demande.

Les autres méthodes et propriétés de l'objet DbDataReader ne doivent pas être appelées tant que la tâche retournée n'est pas terminée. Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par NextResult().

Voir aussi

S’applique à