DbCommand.ExecuteScalarAsync Metódus

Definíció

Névtér:

System.Data.Common

Szerelvények:

netstandard.dll, System.Data.Common.dll

Implementálja a hívószál aszinkron verzióját ExecuteScalar(), de szinkron módon adja vissza Task a hívó szálat.

Túlterhelések

Name	Description
ExecuteScalarAsync()	A parancsot végrehajtó aszinkron verzió ExecuteScalar(), amely az első visszaadott eredményhalmaz első sorának első oszlopát adja vissza. A rendszer figyelmen kívül hagyja az összes többi oszlopot, sort és eredményhalmazt. Meghívja ExecuteScalarAsync(CancellationToken) a CancellationToken.None parancsot.
ExecuteScalarAsync(CancellationToken)	Ez aszinkron verziója.ExecuteScalar() A szolgáltatóknak felül kell bírálni a megfelelő megvalósítást. A lemondási jogkivonat opcionálisan figyelmen kívül hagyható. Az alapértelmezett implementáció meghívja a szinkron ExecuteScalar() metódust, és egy befejezett feladatot ad vissza, blokkolva a hívó szálat. Az alapértelmezett implementáció visszavont feladatot ad vissza, ha már lemondott lemondási jogkivonatot adott át. Az ExecuteScalar által kiadott kivételek a visszaadott Tevékenységkivétel tulajdonságon keresztül lesznek közölve. Ne hívja meg az DbCommand objektum egyéb metódusait és tulajdonságait, amíg a visszaadott feladat be nem fejeződik.

Megjegyzések

Az aszinkron programozásról további információt az Aszinkron programozás című témakörben talál.

ExecuteScalarAsync()

Forrás:

DbCommand.cs

A parancsot végrehajtó aszinkron verzió ExecuteScalar(), amely az első visszaadott eredményhalmaz első sorának első oszlopát adja vissza. A rendszer figyelmen kívül hagyja az összes többi oszlopot, sort és eredményhalmazt.

Meghívja ExecuteScalarAsync(CancellationToken) a CancellationToken.None parancsot.

public:
 System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync();

public System.Threading.Tasks.Task<object?> ExecuteScalarAsync();

member this.ExecuteScalarAsync : unit -> System.Threading.Tasks.Task<obj>

Public Function ExecuteScalarAsync () As Task(Of Object)

Válaszok

Task<Object>

Az aszinkron műveletet képviselő feladat.

Kivételek

DbException

Hiba történt a parancs végrehajtása közben.

Megjegyzések

Az aszinkron programozásról további információt az Aszinkron programozás című témakörben talál.

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

Lásd még

• ADO.NET áttekintése

ExecuteScalarAsync(CancellationToken)

Forrás:

DbCommand.cs

Ez aszinkron verziója.ExecuteScalar() A szolgáltatóknak felül kell bírálni a megfelelő megvalósítást. A lemondási jogkivonat opcionálisan figyelmen kívül hagyható.

Az alapértelmezett implementáció meghívja a szinkron ExecuteScalar() metódust, és egy befejezett feladatot ad vissza, blokkolva a hívó szálat. Az alapértelmezett implementáció visszavont feladatot ad vissza, ha már lemondott lemondási jogkivonatot adott át. Az ExecuteScalar által kiadott kivételek a visszaadott Tevékenységkivétel tulajdonságon keresztül lesznek közölve.

Ne hívja meg az DbCommand objektum egyéb metódusait és tulajdonságait, amíg a visszaadott feladat be nem fejeződik.

public:
 virtual System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task<object?> ExecuteScalarAsync(System.Threading.CancellationToken cancellationToken);

abstract member ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>

Public Overridable Function ExecuteScalarAsync (cancellationToken As CancellationToken) As Task(Of Object)

Paraméterek

cancellationToken

CancellationToken

Jogkivonat az aszinkron művelet megszakításához.

Válaszok

Task<Object>

Az aszinkron műveletet képviselő feladat.

Kivételek

DbException

Hiba történt a parancs végrehajtása közben.

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 további információt az Aszinkron programozás című témakörben talál.

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

Lásd még

• ADO.NET áttekintése