SqlCommand.ExecuteXmlReaderAsync Méthode

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Surcharges

ExecuteXmlReaderAsync()	Version asynchrone de ExecuteXmlReader() , qui envoie le CommandText à et Connection génère un XmlReader objet . Les exceptions seront signalées via l’objet Task retourné.
ExecuteXmlReaderAsync(CancellationToken)	Version asynchrone de ExecuteXmlReader() , qui envoie le CommandText à et Connection génère un XmlReader objet . 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é.

ExecuteXmlReaderAsync()

Version asynchrone de ExecuteXmlReader() , qui envoie le CommandText à et Connection génère un XmlReader objet .

Les exceptions seront signalées via l’objet Task retourné.

public:
 System::Threading::Tasks::Task<System::Xml::XmlReader ^> ^ ExecuteXmlReaderAsync();

public System.Threading.Tasks.Task<System.Xml.XmlReader> ExecuteXmlReaderAsync ();

member this.ExecuteXmlReaderAsync : unit -> System.Threading.Tasks.Task<System.Xml.XmlReader>

Public Function ExecuteXmlReaderAsync () As Task(Of XmlReader)

Retours

Task<XmlReader>

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

Exceptions

InvalidCastException

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 .

InvalidOperationException

Appels multiples de ExecuteScalarAsync(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.

SqlException

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.

IOException

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.

ObjectDisposedException

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

Le XmlReader retourné par cette méthode ne prend pas en charge les opérations asynchrones. 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 ExecuteXmlReader 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 .

ExecuteXmlReaderAsync(CancellationToken)

Version asynchrone de ExecuteXmlReader() , qui envoie le CommandText à et Connection génère un XmlReader objet .

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::Xml::XmlReader ^> ^ ExecuteXmlReaderAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Xml.XmlReader> ExecuteXmlReaderAsync (System.Threading.CancellationToken cancellationToken);

member this.ExecuteXmlReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Xml.XmlReader>

Public Function ExecuteXmlReaderAsync (cancellationToken As CancellationToken) As Task(Of XmlReader)

Paramètres

cancellationToken

CancellationToken

Instruction d'annulation.

Retours

Task<XmlReader>

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

Exceptions

InvalidCastException

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 .

InvalidOperationException

Appels multiples de ExecuteScalarAsync(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.

SqlException

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.

IOException

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.

ObjectDisposedException

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

Le XmlReader retourné par cette méthode ne prend pas en charge les opérations asynchrones. Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.