SqlCommand.ExecuteNonQueryAsync(CancellationToken) Metódus

Definíció

Névtér:

System.Data.SqlClient

Szerelvény:

System.Data.dll

A ExecuteNonQuery() aszinkron verziója, amely egy Transact-SQL utasítást hajt végre a kapcsolaton, és visszaadja az érintett sorok számát. 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:
 override System::Threading::Tasks::Task<int> ^ ExecuteNonQueryAsync(System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<int> ExecuteNonQueryAsync(System.Threading.CancellationToken cancellationToken);

override this.ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

Public Overrides Function ExecuteNonQueryAsync (cancellationToken As CancellationToken) As Task(Of Integer)

Paraméterek

cancellationToken

CancellationToken

A lemondási utasítás.

Válaszok

Task<Int32>

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.

InvalidOperationException

A feladat befejezése előtt többször hívhat ExecuteNonQueryAsync(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 ExecuteNonQuery()kiadott kivételeket: .

Lásd még

• ADO.NET áttekintése