Partager via


SqlCommand.ExecuteReaderAsync Méthode

Définition

Lance l’exécution asynchrone de l’instruction Transact-SQL ou de la procédure stockée qui est décrite par ce SqlCommand.

Surcharges

ExecuteReaderAsync()

Version asynchrone de ExecuteReader(), qui envoie le CommandText au Connection et génère un SqlDataReader. Les exceptions seront signalées via l’objet Task retourné.

ExecuteReaderAsync(CommandBehavior)

Version asynchrone d’ExecuteReader(CommandBehavior), qui envoie le CommandText au Connection et génère un SqlDataReader. Les exceptions seront signalées via l’objet Task retourné.

ExecuteReaderAsync(CancellationToken)

Version asynchrone de ExecuteReader(), qui envoie le CommandText au Connection et génère un SqlDataReader.

Le jeton d'annulation peut être utilisé pour demander que l'opération soit abandonnée avant que le délai d'attente de commande s'écoule. Les exceptions seront signalées via l’objet Task retourné.

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Version asynchrone de ExecuteReader(CommandBehavior), qui envoie le CommandText au Connection et génère un SqlDataReader.

Le jeton d'annulation peut être utilisé pour demander que l'opération soit abandonnée avant que le délai d'attente de commande s'écoule. Les exceptions seront signalées via l’objet Task retourné.

Remarques

Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.

ExecuteReaderAsync()

Version asynchrone de ExecuteReader(), qui envoie le CommandText au Connection et génère un SqlDataReader. Les exceptions seront signalées via l’objet Task retourné.

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync();
public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync ();
override this.ExecuteReaderAsync : unit -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>
Public Function ExecuteReaderAsync () As Task(Of SqlDataReader)

Retours

Tâche représentant l’opération asynchrone.

Exceptions

Un SqlDbType autre que Binary ou VarBinary a été utilisé quand Value avait la valeur Stream. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

- ou -

Autre SqlDbType que Char, NChar, NVarChar, VarChar ou Xml a été utilisé lorsque Value a été défini sur TextReader.

- ou -

Un SqlDbType autre que Xml a été utilisé quand Value avait la valeur XmlReader.

Valeur CommandBehavior non valide.

Appels multiples de ExecuteReaderAsync() pour la même instance avant la fin de la tâche.

- ou -

La SqlConnection a été fermée ou supprimée pendant une opération de diffusion en continu. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

- ou -

Context Connection=true est spécifié dans la chaîne de connexion.

SQL Server a retourné une erreur pendant l’exécution du texte de commande.

- ou -

Un délai d’attente a été dépassé pendant une opération de diffusion en continu. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

Une erreur s’est produite dans un objet Stream, XmlReader ou TextReader pendant une opération de diffusion en continu. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

L’objet Stream, XmlReader ou TextReader a été fermé pendant une opération de diffusion en continu. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

Remarques

Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.

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 ExecuteReader().

Voir aussi

S’applique à

ExecuteReaderAsync(CommandBehavior)

Version asynchrone d’ExecuteReader(CommandBehavior), qui envoie le CommandText au Connection et génère un SqlDataReader. Les exceptions seront signalées via l’objet Task retourné.

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior);
public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync (System.Data.CommandBehavior behavior);
override this.ExecuteReaderAsync : System.Data.CommandBehavior -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>
Public Function ExecuteReaderAsync (behavior As CommandBehavior) As Task(Of SqlDataReader)

Paramètres

behavior
CommandBehavior

Options pour l'exécution des instructions et la récupération des données. Quand défini sur Default, ReadAsync(CancellationToken), lit la ligne entière avant de retourner une tâche terminée.

Retours

Tâche représentant l’opération asynchrone.

Exceptions

Un SqlDbType autre que Binary ou VarBinary a été utilisé quand Value avait la valeur Stream. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

- ou -

Autre SqlDbType que Char, NChar, NVarChar, VarChar ou Xml a été utilisé lorsque Value a été défini sur TextReader.

- ou -

Un SqlDbType autre que Xml a été utilisé quand Value avait la valeur XmlReader.

Valeur CommandBehavior non valide.

Appels multiples de ExecuteReaderAsync(CommandBehavior) pour la même instance avant la fin de la tâche.

- ou -

La SqlConnection a été fermée ou supprimée pendant une opération de diffusion en continu. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

- ou -

Context Connection=true est spécifié dans la chaîne de connexion.

SQL Server a retourné une erreur pendant l’exécution du texte de commande.

- ou -

Un délai d’attente a été dépassé pendant une opération de diffusion en continu. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

Une erreur s’est produite dans un objet Stream, XmlReader ou TextReader pendant une opération de diffusion en continu. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

L’objet Stream, XmlReader ou TextReader a été fermé pendant une opération de diffusion en continu. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

Remarques

Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.

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 ExecuteReader(CommandBehavior).

Voir aussi

S’applique à

ExecuteReaderAsync(CancellationToken)

Version asynchrone de ExecuteReader(), qui envoie le CommandText au Connection et génère un SqlDataReader.

Le jeton d'annulation peut être utilisé pour demander que l'opération soit abandonnée avant que le délai d'attente de commande s'écoule. Les exceptions seront signalées via l’objet Task retourné.

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync (System.Threading.CancellationToken cancellationToken);
override this.ExecuteReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>
Public Function ExecuteReaderAsync (cancellationToken As CancellationToken) As Task(Of SqlDataReader)

Paramètres

cancellationToken
CancellationToken

Instruction d'annulation.

Retours

Tâche représentant l’opération asynchrone.

Exceptions

Un SqlDbType autre que Binary ou VarBinary a été utilisé quand Value avait la valeur Stream. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

- ou -

Autre SqlDbType que Char, NChar, NVarChar, VarChar ou Xml a été utilisé lorsque Value a été défini sur TextReader.

- ou -

Un SqlDbType autre que Xml a été utilisé quand Value avait la valeur XmlReader.

Valeur CommandBehavior non valide.

Appels multiples de ExecuteReaderAsync(CommandBehavior, CancellationToken) pour la même instance avant la fin de la tâche.

- ou -

La SqlConnection a été fermée ou supprimée pendant une opération de diffusion en continu. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

- ou -

Context Connection=true est spécifié dans la chaîne de connexion.

SQL Server a retourné une erreur pendant l’exécution du texte de commande.

- ou -

Un délai d’attente a été dépassé pendant une opération de diffusion en continu. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

Une erreur s’est produite dans un objet Stream, XmlReader ou TextReader pendant une opération de diffusion en continu. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

L’objet Stream, XmlReader ou TextReader a été fermé pendant une opération de diffusion en continu. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

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

Remarques

Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par ExecuteReader().

Voir aussi

S’applique à

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Version asynchrone de ExecuteReader(CommandBehavior), qui envoie le CommandText au Connection et génère un SqlDataReader.

Le jeton d'annulation peut être utilisé pour demander que l'opération soit abandonnée avant que le délai d'attente de commande s'écoule. Les exceptions seront signalées via l’objet Task retourné.

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync (System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);
override this.ExecuteReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>
Public Function ExecuteReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of SqlDataReader)

Paramètres

behavior
CommandBehavior

Options pour l'exécution des instructions et la récupération des données. Quand défini sur Default, ReadAsync(CancellationToken), lit la ligne entière avant de retourner une tâche terminée.

cancellationToken
CancellationToken

Instruction d'annulation.

Retours

Tâche représentant l’opération asynchrone.

Exceptions

Un SqlDbType autre que Binary ou VarBinary a été utilisé quand Value avait la valeur Stream. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

- ou -

Un SqlDbType autre que Char, NChar, NVarChar, VarChar ou Xml a été utilisé quand Value a été défini sur TextReader.

- ou -

Un SqlDbType autre que Xml a été utilisé quand Value avait la valeur XmlReader.

Valeur CommandBehavior non valide.

Appels multiples de ExecuteReaderAsync(CommandBehavior, CancellationToken) pour la même instance avant la fin de la tâche.

- ou -

La SqlConnection a été fermée ou supprimée pendant une opération de diffusion en continu. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

- ou -

Context Connection=true est spécifié dans la chaîne de connexion.

SQL Server a retourné une erreur pendant l’exécution du texte de commande.

- ou -

Un délai d’attente a été dépassé pendant une opération de diffusion en continu. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

Une erreur s’est produite dans un objet Stream, XmlReader ou TextReader pendant une opération de diffusion en continu. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

L’objet Stream, XmlReader ou TextReader a été fermé pendant une opération de diffusion en continu. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.

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

Remarques

Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par ExecuteReader(CommandBehavior).

Voir aussi

S’applique à