SqlCommand.EndExecuteNonQuery(IAsyncResult) Metódus

Definíció

Névtér:
System.Data.SqlClient
Szerelvény:
System.Data.dll
Forrás:
System.Data.SqlClient.notsupported.cs

Befejezi egy Transact-SQL utasítás aszinkron végrehajtását.

public:
 int EndExecuteNonQuery(IAsyncResult ^ asyncResult);
public int EndExecuteNonQuery(IAsyncResult asyncResult);
member this.EndExecuteNonQuery : IAsyncResult -> int
Public Function EndExecuteNonQuery (asyncResult As IAsyncResult) As Integer

Paraméterek

asyncResult
IAsyncResult

A IAsyncResult hívás BeginExecuteNonQuery()által visszaadott .

Válaszok

Int32

Az érintett sorok száma (ugyanaz a viselkedés, mint ExecuteNonQuery()a ).

Kivételek

ArgumentException

asyncResult paraméter null (Nothing Microsoft Visual Basic)

InvalidOperationException

EndExecuteNonQuery(IAsyncResult)többször is meghívták egyetlen parancsvégrehajtáshoz, vagy a metódus nem felelt meg a végrehajtási módszernek (például a hívás végrehajtásának befejezéséhez EndExecuteNonQuery(IAsyncResult)hívott BeginExecuteXmlReader() kód).

SqlException

Az eltelt idő CommandTimeout és a megadott BeginExecuteNonQuery aszinkron művelet nem fejeződött be.

-vagy-

Bizonyos helyzetekben IAsyncResult helytelenül IsCompleted állítható be. Ha ez történik, és EndExecuteNonQuery(IAsyncResult) a rendszer meghívja, az EndExecuteNonQuery SqlException hibát okozhat, ha az eltelt idő CommandTimeout és a megadott BeginExecuteNonQuery aszinkron művelet nem fejeződött be. A helyzet megoldásához növelje a CommandTimeout értékét, vagy csökkentse az aszinkron művelet által végzett munkát.

Példák

A metódus használatát EndExecuteNonQuery bemutató példákért lásd BeginExecuteNonQuery: .

Megjegyzések

Amikor meghívja BeginExecuteNonQuery egy Transact-SQL utasítás végrehajtásához, a művelet végrehajtásához meg kell hívnia EndExecuteNonQuery. Ha a parancs végrehajtásának folyamata még nem fejeződött be, ez a metódus letiltja a művelet befejezését. A felhasználók a metódus által visszaadott példány használatával IAsyncResult ellenőrizhetik, hogy a parancs végrehajtotta-e a BeginExecuteNonQuery műveletet. Ha a hívásban BeginExecuteNonQueryvisszahívási eljárást adott meg, ezt a metódust kell meghívni.

A következőre érvényes:

Lásd még