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.
Lance l’exécution asynchrone de l’instruction Transact-SQL ou de la procédure stockée décrite par ceci SqlCommand.
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) |
Version asynchrone de ExecuteReader(CommandBehavior), 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é. |
Remarques
Pour plus d’informations sur la programmation asynchrone dans .NET Framework Fournisseur de données pour SQL Server, consultez Asynchronous Programming.
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é.
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 il 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.
-ou-
Un SqlDbType autre que Char, NChar, NVarChar, VarChar ou Xml a été utilisé quand Value il a été défini sur TextReader.
-ou-
Un SqlDbType autre que Xml a été utilisé lorsqu’il Value a été défini sur XmlReader.
Valeur non valide CommandBehavior .
Appel ExecuteReaderAsync() plusieurs fois pour la même instance avant la fin de la tâche.
-ou-
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.
-ou-
Context Connection=true est spécifié dans le chaîne de connexion.
SQL Server retourné une erreur lors de l’exécution du texte de la commande.
-ou-
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.
Une erreur s’est produite dans un objet ou StreamXmlReader 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.
L’objet ou Stream l’objet XmlReaderTextReader 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.
Cette méthode stocke dans la tâche toutes les exceptions 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 est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par ExecuteReader().
Voir aussi
S’applique à
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é.
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 la valeur est définie Default, ReadAsync(CancellationToken) lit la ligne entière avant de renvoyer une tâche complète.
Retours
Tâche représentant l’opération asynchrone.
Exceptions
Un SqlDbType autre que Binary ou VarBinary a été utilisé quand Value il 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.
-ou-
Un SqlDbType autre que Char, NChar, NVarChar, VarChar ou Xml a été utilisé quand Value il a été défini sur TextReader.
-ou-
Un SqlDbType autre que Xml a été utilisé lorsqu’il Value a été défini sur XmlReader.
Valeur non valide CommandBehavior .
Appel ExecuteReaderAsync(CommandBehavior) plusieurs fois pour la même instance avant la fin de la tâche.
-ou-
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.
-ou-
Context Connection=true est spécifié dans le chaîne de connexion.
SQL Server retourné une erreur lors de l’exécution du texte de la commande.
-ou-
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.
Une erreur s’est produite dans un objet ou StreamXmlReader 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.
L’objet ou Stream l’objet XmlReaderTextReader 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.
Cette méthode stocke dans la tâche toutes les exceptions 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 est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon 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 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<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 il 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.
-ou-
Un SqlDbType autre que Char, NChar, NVarChar, VarChar ou Xml a été utilisé quand Value il a été défini sur TextReader.
-ou-
Un SqlDbType autre que Xml a été utilisé lorsqu’il Value a été défini sur XmlReader.
Valeur non valide CommandBehavior .
Appel ExecuteReaderAsync(CommandBehavior, CancellationToken) plusieurs fois pour la même instance avant la fin de la tâche.
-ou-
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.
-ou-
Context Connection=true est spécifié dans le chaîne de connexion.
SQL Server retourné une erreur lors de l’exécution du texte de la commande.
-ou-
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.
Une erreur s’est produite dans un objet ou StreamXmlReader 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.
L’objet ou Stream l’objet XmlReaderTextReader 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.
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 .NET Framework Fournisseur de données pour SQL Server, consultez Asynchronous Programming.
Cette méthode stocke dans la tâche toutes les exceptions 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 est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour 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 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<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 la valeur est définie Default, 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
Un SqlDbType autre que Binary ou VarBinary a été utilisé quand Value il 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.
-ou-
Un SqlDbType autre que Char, NChar, NVarChar, VarChar ou Xml a été utilisé quand Value il a été défini sur TextReader.
-ou-
Un SqlDbType autre que Xml a été utilisé lorsqu’il Value a été défini sur XmlReader.
Valeur non valide CommandBehavior .
Appel ExecuteReaderAsync(CommandBehavior, CancellationToken) plusieurs fois pour la même instance avant la fin de la tâche.
-ou-
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.
-ou-
Context Connection=true est spécifié dans le chaîne de connexion.
SQL Server retourné une erreur lors de l’exécution du texte de la commande.
-ou-
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.
Une erreur s’est produite dans un objet ou StreamXmlReader 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.
L’objet ou Stream l’objet XmlReaderTextReader 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.
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 .NET Framework Fournisseur de données pour SQL Server, consultez Asynchronous Programming.
Cette méthode stocke dans la tâche toutes les exceptions 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 est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par ExecuteReader(CommandBehavior).