SqlCommand.ExecuteReaderAsync 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.
Overloads
| Name | Description |
|---|---|
| ExecuteReaderAsync() |
Een asynchrone versie van ExecuteReader(), die de CommandText naar de Connection en bouwt een SqlDataReader. Uitzonderingen worden gerapporteerd via het geretourneerde taakobject. |
| ExecuteReaderAsync(CommandBehavior) |
Een asynchrone versie van ExecuteReader(CommandBehavior), die de CommandText naar de Connection, verzendt en een SqlDataReader. Uitzonderingen worden gerapporteerd via het geretourneerde taakobject. |
| ExecuteReaderAsync(CancellationToken) |
Een asynchrone versie van ExecuteReader(), die de CommandText naar de Connection en bouwt een SqlDataReader. 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. |
| ExecuteReaderAsync(CommandBehavior, CancellationToken) |
Een asynchrone versie van ExecuteReader(CommandBehavior), die de naar de CommandTextConnectionene verzendt en een SqlDataReader 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. |
Opmerkingen
Zie Asynchrone programmering voor meer informatie over asynchrone programmering in het .NET Framework Data Provider voor SQL Server.
ExecuteReaderAsync()
Een asynchrone versie van ExecuteReader(), die de CommandText naar de Connection en bouwt een SqlDataReader. Uitzonderingen worden gerapporteerd via het geretourneerde taakobject.
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)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.
Een ongeldige CommandBehavior waarde.
Meer dan één keer aanroepen ExecuteReaderAsync() 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
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 ExecuteReader()de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Zie ook
Van toepassing op
ExecuteReaderAsync(CommandBehavior)
Een asynchrone versie van ExecuteReader(CommandBehavior), die de CommandText naar de Connection, verzendt en een SqlDataReader. Uitzonderingen worden gerapporteerd via het geretourneerde taakobject.
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)Parameters
- behavior
- CommandBehavior
Opties voor het uitvoeren van instructies en het ophalen van gegevens. Wanneer deze is ingesteld Default, ReadAsync(CancellationToken) leest u de hele rij voordat u een volledige taak retourneert.
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.
Een ongeldige CommandBehavior waarde.
Meer dan één keer aanroepen ExecuteReaderAsync(CommandBehavior) 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
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 ExecuteReader(CommandBehavior)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Zie ook
Van toepassing op
ExecuteReaderAsync(CancellationToken)
Een asynchrone versie van ExecuteReader(), die de CommandText naar de Connection en bouwt een SqlDataReader.
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::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)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.
Een ongeldige CommandBehavior waarde.
Meer dan één keer aanroepen ExecuteReaderAsync(CommandBehavior, 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
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 ExecuteReader()de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Zie ook
Van toepassing op
ExecuteReaderAsync(CommandBehavior, CancellationToken)
Een asynchrone versie van ExecuteReader(CommandBehavior), die de naar de CommandTextConnectionene verzendt en een SqlDataReader
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::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)Parameters
- behavior
- CommandBehavior
Opties voor het uitvoeren van instructies en het ophalen van gegevens. Wanneer deze is ingesteld Default, ReadAsync(CancellationToken) leest u de hele rij voordat u een volledige taak retourneert.
- 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.
Een ongeldige CommandBehavior waarde.
Meer dan één keer aanroepen ExecuteReaderAsync(CommandBehavior, 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
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 ExecuteReader(CommandBehavior)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.