SqlCommand.ExecuteReaderAsync Méthode

Définition

Espace de noms:: Microsoft.Data.SqlClient

Assembly:: Microsoft.Data.SqlClient.dll

Paquet:: Microsoft.Data.SqlClient v1.0.19269.1

Paquet:: Microsoft.Data.SqlClient v1.1.4

Paquet:: Microsoft.Data.SqlClient v2.0.1

Paquet:: Microsoft.Data.SqlClient v2.1.4

Paquet:: Microsoft.Data.SqlClient v3.0.1

Paquet:: Microsoft.Data.SqlClient v3.1.0

Paquet:: Microsoft.Data.SqlClient v4.0.1

Paquet:: Microsoft.Data.SqlClient v4.1.0

Paquet:: Microsoft.Data.SqlClient v5.0.0

Paquet:: Microsoft.Data.SqlClient v5.1.0

Paquet:: Microsoft.Data.SqlClient v5.2.0

Paquet:: Microsoft.Data.SqlClient v6.0.2

Paquet:: Microsoft.Data.SqlClient v6.1.3

Paquet:: Microsoft.Data.SqlClient v7.0.1

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.

Surcharges

Nom	Description
ExecuteReaderAsync()	Version asynchrone de ExecuteReader(), qui envoie le CommandText vers le Connection et génère un SqlDataReader. Les exceptions sont signalées via l’objet Task retourné.
ExecuteReaderAsync(CommandBehavior)	Version asynchrone de ExecuteReader(CommandBehavior), qui envoie le CommandText vers le Connection, et génère un SqlDataReader. Les exceptions sont signalées via l’objet Task retourné.
ExecuteReaderAsync(CancellationToken)	Version asynchrone de ExecuteReader(), qui envoie le CommandText vers le Connection et génère un SqlDataReader. Le jeton d’annulation peut être utilisé pour demander que l’opération soit abandonnée avant l’expiration du délai d’expiration de la commande. Les exceptions sont signalées via l’objet Task retourné.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Une version asynchrone de ExecuteReader(CommandBehavior), qui envoie le CommandText vers le Connection, et génère un jeton d’annulation SqlDataReader peut être utilisé pour demander que l’opération soit abandonnée avant l’expiration du délai d’expiration de la commande. Les exceptions sont signalées via l’objet Task retourné.

ExecuteReaderAsync()

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

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

public:
 System::Threading::Tasks::Task<Microsoft::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync();

public System.Threading.Tasks.Task<Microsoft.Data.SqlClient.SqlDataReader> ExecuteReaderAsync();

override this.ExecuteReaderAsync : unit -> System.Threading.Tasks.Task<Microsoft.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync () As Task(Of SqlDataReader)

Retours

Task<SqlDataReader>

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

Exceptions

InvalidCastException

Un SqlDbType autre que Binary ou VarBinary a été utilisé quand Value a été défini sur Stream. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.
Autre SqlDbType que Char, , NChar, NVarChar, VarCharou Xml a été utilisé quand Value a été défini sur TextReader.
Un SqlDbType autre que Xml celui utilisé lors Value de l’utilisation a été défini sur XmlReader.

ArgumentException

Valeur non valide CommandBehavior .

InvalidOperationException

Appel ExecuteReaderAsync() plusieurs fois pour la même instance avant la fin de la tâche.
SqlConnection Fermé ou supprimé pendant une opération de diffusion en continu. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.

SqlException

SQL Server retourné une erreur lors de l’exécution du texte de la commande.
Un délai d’expiration s’est produit pendant une opération de diffusion en continu. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.

IOException

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

ObjectDisposedException

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

Remarques

Pour plus d’informations sur la programmation asynchrone dans .NET Framework Fournisseur de données pour SQL Server, consultez Asynchronous Programming.

Note

Pour les requêtes longues sur le serveur, envisagez d’utiliser ExecuteReader en raison d’un problème connu lié à l’annulation de requêtes via un jeton d’annulation. Envisagez également d’annuler l’exécution à l’aide de la Cancel méthode.

S’applique à

ExecuteReaderAsync(CommandBehavior)

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

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

public:
 System::Threading::Tasks::Task<Microsoft::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior);

public System.Threading.Tasks.Task<Microsoft.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Data.CommandBehavior behavior);

override this.ExecuteReaderAsync : System.Data.CommandBehavior -> System.Threading.Tasks.Task<Microsoft.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 la valeur est définie Default, ReadAsync(CancellationToken) lit la ligne entière avant de renvoyer une tâche complète.

Retours

Task<SqlDataReader>

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

Exceptions

InvalidCastException

Un SqlDbType autre que Binary ou VarBinary a été utilisé quand Value a été défini sur Stream. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.
Autre SqlDbType que Char, , NChar, NVarChar, VarCharou Xml a été utilisé quand Value a été défini sur TextReader.
Un SqlDbType autre que Xml celui utilisé lors Value de l’utilisation a été défini sur XmlReader.

ArgumentException

Valeur non valide CommandBehavior .

InvalidOperationException

Appel ExecuteReaderAsync(CommandBehavior) plusieurs fois pour la même instance avant la fin de la tâche.
SqlConnection fermé ou supprimé pendant une opération de diffusion en continu. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.

SqlException

SQL Server retourné une erreur lors de l’exécution du texte de la commande.
Un délai d’expiration s’est produit pendant une opération de diffusion en continu. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.

IOException

ObjectDisposedException

Remarques

Pour plus d’informations sur la programmation asynchrone dans .NET Framework Fournisseur de données pour SQL Server, consultez Asynchronous Programming.

S’applique à

ExecuteReaderAsync(CancellationToken)

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Version asynchrone de ExecuteReader(), qui envoie le CommandText vers le Connection et génère un SqlDataReader. Le jeton d’annulation peut être utilisé pour demander que l’opération soit abandonnée avant l’expiration du délai d’expiration de la commande. Les exceptions sont signalées via l’objet Task retourné.

public:
 System::Threading::Tasks::Task<Microsoft::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<Microsoft.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Threading.CancellationToken cancellationToken);

override this.ExecuteReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (cancellationToken As CancellationToken) As Task(Of SqlDataReader)

Paramètres

cancellationToken: CancellationToken

Instruction d’annulation.

Retours

Task<SqlDataReader>

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

Exceptions

InvalidCastException

Un SqlDbType autre que Binary ou VarBinary a été utilisé quand Value a été défini sur Stream. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.
Autre SqlDbType que Char, , NChar, NVarChar, VarCharou Xml a été utilisé quand Value a été défini sur TextReader.
Un SqlDbType autre que Xml celui utilisé lors Value de l’utilisation a été défini sur XmlReader.

ArgumentException

Valeur non valide CommandBehavior .

InvalidOperationException

Appel ExecuteReaderAsync(CommandBehavior, CancellationToken) plusieurs fois pour la même instance avant la fin de la tâche.
SqlConnection Fermé ou supprimé pendant une opération de diffusion en continu. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.

SqlException

SQL Server retourné une erreur lors de l’exécution du texte de la commande.
Un délai d’expiration s’est produit pendant une opération de diffusion en continu. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.

IOException

ObjectDisposedException

Remarques

Pour plus d’informations sur la programmation asynchrone dans .NET Framework Fournisseur de données pour SQL Server, consultez Asynchronous Programming.

S’applique à

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Une version asynchrone de ExecuteReader(CommandBehavior), qui envoie le CommandText vers le Connection, et génère un jeton d’annulation SqlDataReader peut être utilisé pour demander que l’opération soit abandonnée avant l’expiration du délai d’expiration de la commande. Les exceptions sont signalées via l’objet Task retourné.

public:
 System::Threading::Tasks::Task<Microsoft::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<Microsoft.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<Microsoft.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of SqlDataReader)

Paramètres

behavior: CommandBehavior

cancellationToken: CancellationToken

Instruction d’annulation.

Retours

Task<SqlDataReader>

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

Exceptions

InvalidCastException

Un SqlDbType autre que Binary ou VarBinary a été utilisé quand Value a été défini sur Stream. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.
Autre SqlDbType que Char, , NChar, NVarChar, VarCharou Xml a été utilisé quand Value a été défini sur TextReader.
Un SqlDbType autre que Xml celui utilisé lors Value de l’utilisation a été défini sur XmlReader.

ArgumentException

Valeur non valide CommandBehavior .

InvalidOperationException

Appel ExecuteReaderAsync(CommandBehavior, CancellationToken) plusieurs fois pour la même instance avant la fin de la tâche.
SqlConnection Fermé ou supprimé pendant une opération de diffusion en continu. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.

SqlException

SQL Server retourné une erreur lors de l’exécution du texte de la commande.
Un délai d’expiration s’est produit pendant une opération de diffusion en continu. Pour plus d’informations sur la diffusion en continu, consultez Prise en charge de la diffusion en continu SqlClient.

IOException

ObjectDisposedException

Remarques

Pour plus d’informations sur la programmation asynchrone dans .NET Framework Fournisseur de données pour SQL Server, consultez Asynchronous Programming.

S’applique à