SqlCommand.ExecuteReaderAsync 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.
Surcharges
| ExecuteReaderAsync() |
Une version asynchrone de ExecuteReader() , qui envoie le CommandText à et Connection génère un SqlDataReader . Les exceptions seront signalées via l’objet Task retourné. |
| ExecuteReaderAsync(CommandBehavior) |
Une version asynchrone de ExecuteReader(CommandBehavior) , qui envoie le CommandText à et Connection génère un SqlDataReader . Les exceptions seront signalées via l’objet Task retourné. |
| ExecuteReaderAsync(CancellationToken) |
Une version asynchrone de ExecuteReader() , qui envoie le CommandText à et Connection 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) |
Une version asynchrone de , qui envoie le CommandText à et Connection génère un SqlDataReader jeton d’annulation Peut être utilisée pour demander l’abandon de ExecuteReader(CommandBehavior) l’opération avant l’expiration du délai d’expiration de la commande. Les exceptions seront signalées via l’objet Task retourné. |
ExecuteReaderAsync()
Une version asynchrone de ExecuteReader() , qui envoie le CommandText à et Connection génère un SqlDataReader . Les exceptions seront 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
Tâche représentant l’opération asynchrone.
Exceptions
Autre SqlDbType que Binary ou VarBinary a été utilisé lorsque Value a été défini sur 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é lorsque Value a été défini sur 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.
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 Stream objet ou XmlReaderTextReader 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 ou XmlReaderTextReader 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.
Notes
Pour les requêtes de longue durée sur le serveur, envisagez d’utiliser ExecuteReader en raison d’un problème connu d’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)
Une version asynchrone de ExecuteReader(CommandBehavior) , qui envoie le CommandText à et Connection génère un SqlDataReader . Les exceptions seront 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 est défini surDefault , ReadAsync(CancellationToken) lit la ligne entière avant de retourner une tâche complète.
Retours
Tâche représentant l’opération asynchrone.
Exceptions
Autre SqlDbType que Binary ou VarBinary a été utilisé lorsque Value a été défini sur 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é lorsque Value a été défini sur XmlReader .
Valeur CommandBehavior non valide.
Appels multiples de ExecuteReaderAsync(CommandBehavior) pour la même instance avant la fin de la tâche.
- ou - SqlConnection fermé ou supprimé lors d’une opération de diffusion en continu. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.
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 Stream objet ou XmlReaderTextReader 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 ou XmlReaderTextReader 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.
S’applique à
ExecuteReaderAsync(CancellationToken)
Une version asynchrone de ExecuteReader() , qui envoie le CommandText à et Connection 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<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
Tâche représentant l’opération asynchrone.
Exceptions
Autre SqlDbType que Binary ou VarBinary a été utilisé lorsque Value a été défini sur 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é lorsque Value a été défini sur 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.
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 Stream objet ou XmlReaderTextReader 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 ou XmlReaderTextReader 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.
S’applique à
ExecuteReaderAsync(CommandBehavior, CancellationToken)
Une version asynchrone de ExecuteReader(CommandBehavior) , qui envoie le CommandText à et Connection génère un SqlDataReader jeton d’annulation Peut être utilisée pour demander l’abandon de l’opération avant l’expiration du délai d’expiration de la commande. Les exceptions seront 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
Options pour l'exécution des instructions et la récupération des données. Quand est défini surDefault , ReadAsync(CancellationToken) lit la ligne entière avant de renvoyer une tâche complète.
- cancellationToken
- CancellationToken
Instruction d'annulation.
Retours
Tâche représentant l’opération asynchrone.
Exceptions
Autre SqlDbType que Binary ou VarBinary a été utilisé lorsque Value a été défini sur 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é lorsque Value a été défini sur 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.
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 Stream objet ou XmlReaderTextReader 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 ou XmlReaderTextReader 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.