SqlCommand.ExecuteNonQueryAsync(CancellationToken) Metoda

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Asynchronní verze ExecuteNonQuery() , která provádí transact-SQL příkaz proti připojení a vrací počet ovlivněných řádků. Token zrušení lze použít k vyžádání, aby byla operace zrušena 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<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)

Parametry

cancellationToken

CancellationToken

Instrukce zrušení

Návraty

Task<Int32>

Úloha představující asynchronní operaci

Výjimky

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 se použila Value jiná hodnota než XML.

InvalidOperationException

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

-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 při provádění textu příkazu vrátil chybu.

-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 zavř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í ve 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í ExecuteNonQuery 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 .