SqlCommand.ExecuteXmlReaderAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Initierar den asynkrona körningen av Transact-SQL-instruktionen eller den lagrade proceduren som beskrivs av den här SqlCommand och returnerar resultat som ett XmlReader-objekt.
Överlagringar
| Name | Description |
|---|---|
| ExecuteXmlReaderAsync() |
En asynkron version av ExecuteXmlReader(), som skickar CommandText till Connection och skapar ett XmlReader objekt. Undantag rapporteras via det returnerade aktivitetsobjektet. |
| ExecuteXmlReaderAsync(CancellationToken) |
En asynkron version av ExecuteXmlReader(), som skickar CommandText till Connection och skapar ett XmlReader objekt. Annulleringstoken kan användas för att begära att åtgärden avbryts innan tidsgränsen för kommandot förflutit. Undantag rapporteras via det returnerade aktivitetsobjektet. |
ExecuteXmlReaderAsync()
En asynkron version av ExecuteXmlReader(), som skickar CommandText till Connection och skapar ett XmlReader objekt.
Undantag rapporteras via det returnerade aktivitetsobjektet.
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)Returer
En uppgift som representerar den asynkrona åtgärden.
Undantag
En SqlDbType annan än Binär eller VarBinary användes när Value var inställd på Stream. Mer information om strömning finns i SqlClient Streaming Support.
-eller-
En SqlDbType annan än Char, NChar, NVarChar, VarChar eller Xml användes när Value var inställd på TextReader.
-eller-
Ett SqlDbType annat än XML användes när Value var inställt på XmlReader.
Anropa ExecuteScalarAsync(CancellationToken) mer än en gång för samma instans innan uppgiften slutförs.
-eller-
Den SqlConnection stängda eller borttagna under en strömningsåtgärd. Mer information om strömning finns i SqlClient Streaming Support.
-eller-
Context Connection=true anges i reťazec pripojenia.
SQL Server returnerade ett fel när kommandotexten kördes.
-eller-
En timeout inträffade under en strömningsåtgärd. Mer information om strömning finns i SqlClient Streaming Support.
Ett fel uppstod i ett Stream- XmlReader eller TextReader -objekt under en strömningsåtgärd. Mer information om strömning finns i SqlClient Streaming Support.
Objektet Stream, XmlReader eller TextReader stängdes under en strömningsåtgärd. Mer information om strömning finns i SqlClient Streaming Support.
Kommentarer
XmlReader som returneras av den här metoden stöder inte asynkrona åtgärder.
Mer information om asynkron programmering i .NET Framework-Data Provider för SQL Server finns i Asynkron programmering.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av ExecuteXmlReader().
Se även
Gäller för
ExecuteXmlReaderAsync(CancellationToken)
En asynkron version av ExecuteXmlReader(), som skickar CommandText till Connection och skapar ett XmlReader objekt.
Annulleringstoken kan användas för att begära att åtgärden avbryts innan tidsgränsen för kommandot förflutit. Undantag rapporteras via det returnerade aktivitetsobjektet.
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)Parametrar
- cancellationToken
- CancellationToken
Instruktionen för annullering.
Returer
En uppgift som representerar den asynkrona åtgärden.
Undantag
En SqlDbType annan än Binär eller VarBinary användes när Value var inställd på Stream. Mer information om strömning finns i SqlClient Streaming Support.
-eller-
En SqlDbType annan än Char, NChar, NVarChar, VarChar eller Xml användes när Value var inställd på TextReader.
-eller-
Ett SqlDbType annat än XML användes när Value var inställt på XmlReader.
Anropa ExecuteScalarAsync(CancellationToken) mer än en gång för samma instans innan uppgiften slutförs.
-eller-
Den SqlConnection stängda eller borttagna under en strömningsåtgärd. Mer information om strömning finns i SqlClient Streaming Support.
-eller-
Context Connection=true anges i reťazec pripojenia.
SQL Server returnerade ett fel när kommandotexten kördes.
-eller-
En timeout inträffade under en strömningsåtgärd. Mer information om strömning finns i SqlClient Streaming Support.
Ett fel uppstod i ett Stream- XmlReader eller TextReader -objekt under en strömningsåtgärd. Mer information om strömning finns i SqlClient Streaming Support.
Objektet Stream, XmlReader eller TextReader stängdes under en strömningsåtgärd. Mer information om strömning finns i SqlClient Streaming Support.
Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.
Kommentarer
XmlReader som returneras av den här metoden stöder inte asynkrona åtgärder.
Mer information om asynkron programmering i .NET Framework-Data Provider för SQL Server finns i Asynkron programmering.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av ExecuteXmlReader().