SqlCommand.EndExecuteNonQuery(IAsyncResult) Metoda

Reference

Definice

Obor názvů:: System.Data.SqlClient

Sestavení:: System.Data.dll

Sestavení:: netstandard.dll, System.Data.SqlClient.dll

Balíček:: System.Data.SqlClient v4.8.6

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Dokončí asynchronní spuštění příkazu Jazyka Transact-SQL.

public:
 int EndExecuteNonQuery(IAsyncResult ^ asyncResult);

public int EndExecuteNonQuery (IAsyncResult asyncResult);

member this.EndExecuteNonQuery : IAsyncResult -> int

Public Function EndExecuteNonQuery (asyncResult As IAsyncResult) As Integer

Parametry

asyncResult: IAsyncResult

Hodnota IAsyncResult vrácená voláním BeginExecuteNonQuery().

Návraty

Int32

Počet ovlivněných řádků (stejné chování jako ExecuteNonQuery()).

Výjimky

ArgumentException

asyncResult parametr má hodnotu null (Nothing v Microsoft Visual Basicu)

InvalidOperationException

EndExecuteNonQuery(IAsyncResult) byl volána více než jednou pro spuštění jednoho příkazu nebo se metoda neshodovala s metodou provádění (například kód volaný EndExecuteNonQuery(IAsyncResult) k dokončení spuštění volání BeginExecuteXmlReader()příkazu .

SqlException

Doba zadaná v CommandTimeout uplynulé době a asynchronní operace zadané pomocí BeginExecuteNonQuery není dokončena.

-nebo-

V některých situacích IAsyncResult může být nesprávně nastavena na IsCompleted hodnotu. Pokud k tomu dojde a EndExecuteNonQuery(IAsyncResult) je volána, EndExecuteNonQuery může vyvolat chybu SqlException, pokud uplynula doba a CommandTimeout asynchronní operace zadaná pomocí BeginExecuteNonQuery není dokončena. Chcete-li tuto situaci vyřešit, měli byste buď zvýšit hodnotu CommandTimeout, nebo snížit práci prováděnou asynchronní operací.

Příklady

Příklady demonstrující použití metody najdete v EndExecuteNonQuery tématu BeginExecuteNonQuery.

Poznámky

Při volání BeginExecuteNonQuery ke spuštění příkazu Jazyka Transact-SQL je nutné volat EndExecuteNonQuery , aby se operace dokončila. Pokud se proces spuštění příkazu ještě nedokončil, tato metoda blokuje, dokud se operace nedokončí. Uživatelé můžou ověřit, že příkaz dokončil svou operaci pomocí IAsyncResult instance vrácené metodou BeginExecuteNonQuery . Pokud byla ve volání BeginExecuteNonQueryzadána procedura zpětného volání , musí být volána tato metoda.

Platí pro

Sdílet prostřednictvím