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.

Új fejlesztéshez használja a Microsoft. Data.SqlClient. Ez a lap a System.Data.SqlClient fájlokat tartalmazza.

Túlterhelések

Név	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. Új fejlesztéshez használja a Microsoft. Data.SqlClient. Ez a lap a System.Data.SqlClient fájlokat tartalmazza.
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. <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>
ExecuteReaderAsync(CancellationToken)	Aszinkron verziója ExecuteReader(), amely elküldi a rendszernek, CommandTextConnection és létrehoz egy SqlDataReader. The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Aszinkron verziója ExecuteReader(CommandBehavior), amely elküldi a CommandText következőt a Connectionrendszernek, és létrehoz egy SqlDataReader The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>

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.

Új fejlesztéshez használja a Microsoft. Data.SqlClient. Ez a lap a System.Data.SqlClient fájlokat tartalmazza.

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.

      <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>

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.

      The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.

      <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>

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

      The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.

      <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>

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