SqlCommand.ExecuteReaderAsync Metódus

Definíció

Névtér:

System.Data.SqlClient

Szerelvény:

System.Data.dll

Elindítja a Transact-SQL utasítás vagy a tárolt eljárás aszinkron végrehajtását, amelyet az SqlCommand ír le.

Túlterhelések

Name	Description
ExecuteReaderAsync()	Aszinkron verziója ExecuteReader(), amely elküldi a rendszernek, CommandTextConnection és létrehoz egy SqlDataReader. A kivételek a visszaadott tevékenységobjektumon keresztül lesznek jelentve.
ExecuteReaderAsync(CommandBehavior)	A rendszer aszinkron verziója ExecuteReader(CommandBehavior), amely elküldi a CommandTextConnectionrendszernek, és létrehoz egy SqlDataReader. A kivételek a visszaadott tevékenységobjektumon keresztül lesznek jelentve.
ExecuteReaderAsync(CancellationToken)	Aszinkron verziója ExecuteReader(), amely elküldi a rendszernek, CommandTextConnection és létrehoz egy SqlDataReader. 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.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Aszinkron verziója ExecuteReader(CommandBehavior), amely elküldi a CommandText következőt a Connectionrendszernek, és létrehoz egy SqlDataReader 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.

Megjegyzések

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.

ExecuteReaderAsync()

Aszinkron verziója ExecuteReader(), amely elküldi a rendszernek, CommandTextConnection és létrehoz egy SqlDataReader. A kivételek a visszaadott tevékenységobjektumon keresztül lesznek jelentve.

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)

Válaszok

Task<SqlDataReader>

Az aszinkron műveletet képviselő feladat.

Kivételek

InvalidCastException

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.

ArgumentException

Érvénytelen CommandBehavior érték.

InvalidOperationException

A feladat befejezése előtt többször hívhat ExecuteReaderAsync() 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.

SqlException

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.

IOException

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.

ObjectDisposedException

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

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 ExecuteReader()kiadott kivételeket: .

Lásd még

• ADO.NET áttekintése

ExecuteReaderAsync(CommandBehavior)

A rendszer aszinkron verziója ExecuteReader(CommandBehavior), amely elküldi a CommandTextConnectionrendszernek, és létrehoz egy SqlDataReader. A kivételek a visszaadott tevékenységobjektumon keresztül lesznek jelentve.

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)

Paraméterek

behavior

CommandBehavior

Az utasítás végrehajtásának és az adatok lekérésének lehetőségei. Ha be van állítva Default, ReadAsync(CancellationToken) beolvassa a teljes sort, mielőtt teljes feladatot ad vissza.

Válaszok

Task<SqlDataReader>

Az aszinkron műveletet képviselő feladat.

Kivételek

InvalidCastException

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.

ArgumentException

Érvénytelen CommandBehavior érték.

InvalidOperationException

A feladat befejezése előtt többször hívhat ExecuteReaderAsync(CommandBehavior) 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.

SqlException

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.

IOException

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.

ObjectDisposedException

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

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 ExecuteReader(CommandBehavior)kiadott kivételeket: .

Lásd még

• ADO.NET áttekintése

ExecuteReaderAsync(CancellationToken)

Aszinkron verziója ExecuteReader(), amely elküldi a rendszernek, CommandTextConnection és létrehoz egy SqlDataReader.

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::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)

Paraméterek

cancellationToken

CancellationToken

A lemondási utasítás.

Válaszok

Task<SqlDataReader>

Az aszinkron műveletet képviselő feladat.

Kivételek

InvalidCastException

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.

ArgumentException

Érvénytelen CommandBehavior érték.

InvalidOperationException

A feladat befejezése előtt többször hívhat ExecuteReaderAsync(CommandBehavior, 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.

SqlException

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.

IOException

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.

ObjectDisposedException

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.

OperationCanceledException

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

Megjegyzések

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 ExecuteReader()kiadott kivételeket: .

Lásd még

• ADO.NET áttekintése

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Aszinkron verziója ExecuteReader(CommandBehavior), amely elküldi a CommandText következőt a Connectionrendszernek, és létrehoz egy SqlDataReader

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::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)

Paraméterek

behavior

CommandBehavior

Az utasítás végrehajtásának és az adatok lekérésének lehetőségei. Ha be van állítva Default, ReadAsync(CancellationToken) beolvassa a teljes sort, mielőtt teljes feladatot ad vissza.

cancellationToken

CancellationToken

A lemondási utasítás.

Válaszok

Task<SqlDataReader>

Az aszinkron műveletet képviselő feladat.

Kivételek

InvalidCastException

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.

ArgumentException

Érvénytelen CommandBehavior érték.

InvalidOperationException

A feladat befejezése előtt többször hívhat ExecuteReaderAsync(CommandBehavior, 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.

SqlException

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.

IOException

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.

ObjectDisposedException

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.

OperationCanceledException

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

Megjegyzések

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 ExecuteReader(CommandBehavior)kiadott kivételeket: .

Lásd még

• ADO.NET áttekintése