SqlCommand.ExecuteXmlReaderAsync Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Elindítja a Transact-SQL utasítás vagy a tárolt eljárás aszinkron végrehajtását, amelyet ez a SqlCommand ír le, és az eredményeket XmlReader objektumként adja vissza.
Túlterhelések
| Name | Description |
|---|---|
| ExecuteXmlReaderAsync() |
Aszinkron verziója ExecuteXmlReader(), amely elküldi az CommandText objektumot, Connection és létrehoz egy objektumot XmlReader . A kivételek a visszaadott tevékenységobjektumon keresztül lesznek jelentve. |
| ExecuteXmlReaderAsync(CancellationToken) |
Aszinkron verziója ExecuteXmlReader(), amely elküldi az CommandText objektumot, Connection és létrehoz egy objektumot XmlReader . A lemondási jogkivonat használatával kérheti a művelet megszakítását a parancs időtúllépése előtt. A kivételek a visszaadott tevékenységobjektumon keresztül lesznek jelentve. |
ExecuteXmlReaderAsync()
Aszinkron verziója ExecuteXmlReader(), amely elküldi az CommandText objektumot, Connection és létrehoz egy objektumot XmlReader .
A kivételek a visszaadott tevékenységobjektumon keresztül lesznek jelentve.
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)Válaszok
Az aszinkron műveletet képviselő feladat.
Kivételek
A SqlDbTypebináristól vagy a VarBinarytól eltérő függvényt használt a rendszer, amikor Value a beállítás értéke Stream. A streamelésről további információt az SqlClient streamelési támogatásában talál.
-vagy-
A SqlDbTypechar, NChar, NVarChar, VarChar vagy Xml kivételével más is használható volt a beállításnál ValueTextReader.
-vagy-
Az SqlDbTypeXml-fájltól eltérő érték lett használva a ValuebeállításkorXmlReader.
A feladat befejezése előtt többször hívhat ExecuteScalarAsync(CancellationToken) meg ugyanarra a példányra.
-vagy-
A SqlConnection streamelési művelet során bezárt vagy elvetett. A streamelésről további információt az SqlClient streamelési támogatásában talál.
-vagy-
Context Connection=true a kapcsolati karakterlánc van megadva.
SQL Server hibát adott vissza a parancsszöveg végrehajtása közben.
-vagy-
Időtúllépés történt egy streamelési művelet során. A streamelésről további információt az SqlClient streamelési támogatásában talál.
Hiba történt egy Stream, XmlReader vagy TextReader objektumban egy streamelési művelet során. A streamelésről további információt az SqlClient streamelési támogatásában talál.
Az Stream, XmlReader vagy TextReader objektum egy streamelési művelet során lett bezárva. A streamelésről további információt az SqlClient streamelési támogatásában talál.
Megjegyzések
A metódus által visszaadott XmlReader nem támogatja az aszinkron műveleteket.
Az aszinkron programozásról a .NET Keretrendszer Data Provider SQL Server című témakörben talál további információt: Aszinkron programozás.
Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által ExecuteXmlReader()kiadott kivételeket: .
Lásd még
A következőre érvényes:
ExecuteXmlReaderAsync(CancellationToken)
Aszinkron verziója ExecuteXmlReader(), amely elküldi az CommandText objektumot, Connection és létrehoz egy objektumot XmlReader .
A lemondási jogkivonat használatával kérheti a művelet megszakítását a parancs időtúllépése előtt. A kivételek a visszaadott tevékenységobjektumon keresztül lesznek jelentve.
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éterek
- cancellationToken
- CancellationToken
A lemondási utasítás.
Válaszok
Az aszinkron műveletet képviselő feladat.
Kivételek
A SqlDbTypebináristól vagy a VarBinarytól eltérő függvényt használt a rendszer, amikor Value a beállítás értéke Stream. A streamelésről további információt az SqlClient streamelési támogatásában talál.
-vagy-
A SqlDbTypechar, NChar, NVarChar, VarChar vagy Xml kivételével más is használható volt a beállításnál ValueTextReader.
-vagy-
Az SqlDbTypeXml-fájltól eltérő érték lett használva a ValuebeállításkorXmlReader.
A feladat befejezése előtt többször hívhat ExecuteScalarAsync(CancellationToken) meg ugyanarra a példányra.
-vagy-
A SqlConnection streamelési művelet során bezárt vagy elvetett. A streamelésről további információt az SqlClient streamelési támogatásában talál.
-vagy-
Context Connection=true a kapcsolati karakterlánc van megadva.
SQL Server hibát adott vissza a parancsszöveg végrehajtása közben.
-vagy-
Időtúllépés történt egy streamelési művelet során. A streamelésről további információt az SqlClient streamelési támogatásában talál.
Hiba történt egy Stream, XmlReader vagy TextReader objektumban egy streamelési művelet során. A streamelésről további információt az SqlClient streamelési támogatásában talál.
Az Stream, XmlReader vagy TextReader objektum egy streamelési művelet során lett bezárva. A streamelésről további információt az SqlClient streamelési támogatásában talál.
A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.
Megjegyzések
A metódus által visszaadott XmlReader nem támogatja az aszinkron műveleteket.
Az aszinkron programozásról a .NET Keretrendszer Data Provider SQL Server című témakörben talál további információt: Aszinkron programozás.
Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által ExecuteXmlReader()kiadott kivételeket: .
