DbDataReader.ReadAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Avance le lecteur de manière asynchrone jusqu’à l’enregistrement suivant d’un jeu de résultats.
Surcharges
ReadAsync() |
Avance le lecteur de manière asynchrone jusqu’à l’enregistrement suivant d’un jeu de résultats. |
ReadAsync(CancellationToken) |
Avance le lecteur de manière asynchrone jusqu’à l’enregistrement suivant d’un jeu de résultats. |
Remarques
Pour plus d’informations sur la programmation asynchrone, consultez Programmation asynchrone.
ReadAsync()
- Source:
- DbDataReader.cs
- Source:
- DbDataReader.cs
- Source:
- DbDataReader.cs
Avance le lecteur de manière asynchrone jusqu’à l’enregistrement suivant d’un jeu de résultats.
public:
System::Threading::Tasks::Task<bool> ^ ReadAsync();
public System.Threading.Tasks.Task<bool> ReadAsync ();
member this.ReadAsync : unit -> System.Threading.Tasks.Task<bool>
Public Function ReadAsync () As Task(Of Boolean)
Retours
Task<TResult> dont la propriété Result est true
s’il y a plus de lignes 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 Read().
Voir aussi
S’applique à
ReadAsync(CancellationToken)
- Source:
- DbDataReader.cs
- Source:
- DbDataReader.cs
- Source:
- DbDataReader.cs
Avance le lecteur de manière asynchrone jusqu’à l’enregistrement suivant d’un jeu de résultats.
public:
virtual System::Threading::Tasks::Task<bool> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);
public virtual System.Threading.Tasks.Task<bool> ReadAsync (System.Threading.CancellationToken cancellationToken);
abstract member ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Overridable Function ReadAsync (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 lignes 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 Read().