SqlCommand.ExecuteScalarAsync(CancellationToken) Metoda

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Asynchronní verze nástroje ExecuteScalar() , která spustí dotaz asynchronně a vrátí první sloupec prvního řádku v sadě výsledků vrácené dotazem. Další sloupce nebo řádky se ignorují.

Token zrušení lze použít k žádosti o opuštění operace před vypršením časového limitu příkazu. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.

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

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

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

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

Parametry

cancellationToken

CancellationToken

Instrukce zrušení

Návraty

Task<Object>

Úloha představující asynchronní operaci

Výjimky

ArgumentException

Neplatná CommandBehavior hodnota.

InvalidCastException

Při SqlDbType nastavení na Stream hodnotu byla použita Value jiná hodnota než Binary nebo VarBinary. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

-nebo-

Při SqlDbType nastavení na TextReader hodnotu se použila Value jiná hodnota než Char, NChar, NVarChar, VarChar nebo XML.

-nebo-

Při SqlDbType nastavení na XmlReader hodnotu byla použita Value jiná hodnota než XML.

InvalidOperationException

Volání ExecuteScalarAsync(CancellationToken) více než jednou pro stejnou instanci před dokončením úkolu

-nebo-

Zavřený SqlConnection nebo vynechaný během operace streamování. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

SqlException

SQL Server vrátil chybu při provádění textu příkazu.

-nebo-

Během operace streamování došlo k vypršení časového limitu. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

IOException

Během operace streamování došlo v objektu Stream nebo TextReaderXmlReader k chybě. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

ObjectDisposedException

Objekt Stream nebo XmlReaderTextReader byl uzavřen během operace streamování. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

Poznámky

Další informace o asynchronním programování v zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.

Poznámka

U dlouhotrvajících dotazů na serveru zvažte použití ExecuteScalar kvůli známému problému se zrušením dotazů prostřednictvím tokenu zrušení. Zvažte také zrušení provádění pomocí Cancel metody .