SqlCommand.ExecuteXmlReaderAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Start de asynchrone uitvoering van de Transact-SQL instructie of opgeslagen procedure die wordt beschreven door deze SqlCommand en retourneert resultaten als een XmlReader-object.
Overloads
| Name | Description |
|---|---|
| ExecuteXmlReaderAsync() |
Een asynchrone versie van ExecuteXmlReader(), die de CommandText naar het Connection object verzendt en een XmlReader object bouwt. Uitzonderingen worden gerapporteerd via het geretourneerde taakobject. |
| ExecuteXmlReaderAsync(CancellationToken) |
Een asynchrone versie van ExecuteXmlReader(), die de CommandText naar het Connection object verzendt en een XmlReader object bouwt. Het annuleringstoken kan worden gebruikt om aan te vragen dat de bewerking wordt afgelaten voordat de time-out van de opdracht is verstreken. Uitzonderingen worden gerapporteerd via het geretourneerde taakobject. |
ExecuteXmlReaderAsync()
Een asynchrone versie van ExecuteXmlReader(), die de CommandText naar het Connection object verzendt en een XmlReader object bouwt.
Uitzonderingen worden gerapporteerd via het geretourneerde taakobject.
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)Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Een SqlDbType andere dan Binary of VarBinary is gebruikt wanneer Value deze is ingesteld op Stream. Zie Ondersteuning voor sqlClient-streaming voor meer informatie over streaming.
– of –
Een SqlDbType andere naam dan Char, NChar, NVarChar, VarChar of XML is gebruikt wanneer Value deze is ingesteld op TextReader.
– of –
Er is een SqlDbType andere dan XML gebruikt wanneer Value deze is ingesteld op XmlReader.
Meer dan één keer aanroepen ExecuteScalarAsync(CancellationToken) voor hetzelfde exemplaar voordat de taak is voltooid.
– of –
De SqlConnection gesloten of verbroken tijdens een streamingbewerking. Zie Ondersteuning voor sqlClient-streaming voor meer informatie over streaming.
– of –
Context Connection=true is opgegeven in de verbindingsreeks.
SQL Server een fout geretourneerd tijdens het uitvoeren van de opdrachttekst.
– of –
Er is een time-out opgetreden tijdens een streamingbewerking. Zie Ondersteuning voor sqlClient-streaming voor meer informatie over streaming.
Er is een fout opgetreden in een Streamof XmlReaderTextReader object tijdens een streamingbewerking. Zie Ondersteuning voor sqlClient-streaming voor meer informatie over streaming.
Het Streamobject XmlReader of TextReader het object is gesloten tijdens een streamingbewerking. Zie Ondersteuning voor sqlClient-streaming voor meer informatie over streaming.
Opmerkingen
XmlReader die door deze methode wordt geretourneerd, biedt geen ondersteuning voor asynchrone bewerkingen.
Zie Asynchrone programmering voor meer informatie over asynchrone programmering in het .NET Framework Data Provider voor SQL Server.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door ExecuteXmlReader()de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Zie ook
Van toepassing op
ExecuteXmlReaderAsync(CancellationToken)
Een asynchrone versie van ExecuteXmlReader(), die de CommandText naar het Connection object verzendt en een XmlReader object bouwt.
Het annuleringstoken kan worden gebruikt om aan te vragen dat de bewerking wordt afgelaten voordat de time-out van de opdracht is verstreken. Uitzonderingen worden gerapporteerd via het geretourneerde taakobject.
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)Parameters
- cancellationToken
- CancellationToken
De annuleringsinstructie.
Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Een SqlDbType andere dan Binary of VarBinary is gebruikt wanneer Value deze is ingesteld op Stream. Zie Ondersteuning voor sqlClient-streaming voor meer informatie over streaming.
– of –
Een SqlDbType andere naam dan Char, NChar, NVarChar, VarChar of XML is gebruikt wanneer Value deze is ingesteld op TextReader.
– of –
Er is een SqlDbType andere dan XML gebruikt wanneer Value deze is ingesteld op XmlReader.
Meer dan één keer aanroepen ExecuteScalarAsync(CancellationToken) voor hetzelfde exemplaar voordat de taak is voltooid.
– of –
De SqlConnection gesloten of verbroken tijdens een streamingbewerking. Zie Ondersteuning voor sqlClient-streaming voor meer informatie over streaming.
– of –
Context Connection=true is opgegeven in de verbindingsreeks.
SQL Server een fout geretourneerd tijdens het uitvoeren van de opdrachttekst.
– of –
Er is een time-out opgetreden tijdens een streamingbewerking. Zie Ondersteuning voor sqlClient-streaming voor meer informatie over streaming.
Er is een fout opgetreden in een Streamof XmlReaderTextReader object tijdens een streamingbewerking. Zie Ondersteuning voor sqlClient-streaming voor meer informatie over streaming.
Het Streamobject XmlReader of TextReader het object is gesloten tijdens een streamingbewerking. Zie Ondersteuning voor sqlClient-streaming voor meer informatie over streaming.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
XmlReader die door deze methode wordt geretourneerd, biedt geen ondersteuning voor asynchrone bewerkingen.
Zie Asynchrone programmering voor meer informatie over asynchrone programmering in het .NET Framework Data Provider voor SQL Server.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door ExecuteXmlReader()de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.