SqlCommand.ExecuteXmlReaderAsync Méthode

Définition

Espace de noms:

System.Data.SqlClient

Assembly:

System.Data.dll

Lance l’exécution asynchrone de l’instruction Transact-SQL ou de la procédure stockée qui est décrite par ceci SqlCommand et retourne les résultats sous forme d’objet XmlReader .

Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.

Surcharges

Nom	Description
ExecuteXmlReaderAsync()	Version asynchrone de ExecuteXmlReader(), qui envoie les CommandText données à l’objet Connection et génère un XmlReader objet. Les exceptions sont signalées via l’objet Task retourné. Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.
ExecuteXmlReaderAsync(CancellationToken)	Version asynchrone de ExecuteXmlReader(), qui envoie les CommandText données à l’objet Connection et génère un XmlReader objet. The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>

ExecuteXmlReaderAsync()

Version asynchrone de ExecuteXmlReader(), qui envoie les CommandText données à l’objet Connection et génère un XmlReader objet.

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

Pour le nouveau développement, utilisez Microsoft. Data.SqlClient. Cette page documente System.Data.SqlClient.

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

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.

InvalidOperationException

Appel ExecuteScalarAsync(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.

SqlException

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.

IOException

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.

ObjectDisposedException

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

XmlReader retourné par cette méthode ne prend pas en charge les opérations asynchrones.

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

Voir aussi

• Vue d'ensemble d’ADO.NET

ExecuteXmlReaderAsync(CancellationToken)

Version asynchrone de ExecuteXmlReader(), qui envoie les CommandText données à l’objet Connection et génère un XmlReader objet.

      The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.

      <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>

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

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.

InvalidOperationException

Appel ExecuteScalarAsync(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.

SqlException

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.

IOException

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.

ObjectDisposedException

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.

OperationCanceledException

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

Remarques

XmlReader retourné par cette méthode ne prend pas en charge les opérations asynchrones.

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

Voir aussi

• Vue d'ensemble d’ADO.NET