SqlCommand.EndExecuteNonQuery(IAsyncResult) Yöntem

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Transact-SQL deyiminin zaman uyumsuz yürütülmesini tamamlar.

public:
 int EndExecuteNonQuery(IAsyncResult ^ asyncResult);

public int EndExecuteNonQuery(IAsyncResult asyncResult);

member this.EndExecuteNonQuery : IAsyncResult -> int

Public Function EndExecuteNonQuery (asyncResult As IAsyncResult) As Integer

Parametreler

asyncResult

IAsyncResult

IAsyncResult çağrısı BeginExecuteNonQuery() tarafından döndürülen.

Döndürülenler

Int32

Etkilenen satır sayısı (ile aynı davranış ExecuteNonQuery() ).

Özel durumlar

ArgumentException

asyncResult parametre null ( Nothing Microsoft Visual Basic'te)

InvalidOperationException

EndExecuteNonQuery(IAsyncResult)tek bir komut yürütmesi için birden çok kez çağrıldı veya yöntemi yürütme yöntemiyle eşleşmedi (örneğin, çağrısının BeginExecuteXmlReader() yürütülmesini tamamlamak için çağrılan EndExecuteNonQuery(IAsyncResult) kod).

SqlException

Geçen sürede belirtilen CommandTimeout süre ve ile BeginExecuteNonQuery() belirtilen zaman uyumsuz işlem tamamlanmaz.

-veya-

Bazı durumlarda, IAsyncResult IsCompleted Yanlış. Bu oluşursa ve EndExecuteNonQuery(IAsyncResult) çağrılırsa EndExecuteNonQuery, içinde belirtilen süre ve ile BeginExecuteNonQuery() belirtilen CommandTimeout zaman uyumsuz işlem tamamlanmazsa bir SqlException hatasına neden olabilir. Bu durumu düzeltmek için CommandTimeout değerini artırmanız veya zaman uyumsuz işlem tarafından yapılan işi azaltmanız gerekir.

Örnekler

yönteminin kullanımını EndExecuteNonQuery gösteren örnekler için bkz BeginExecuteNonQuery(). .

Açıklamalar

Bir Transact-SQL deyimini yürütmek için çağırdığınızda BeginExecuteNonQuery() , işlemi tamamlamak için çağırmanız EndExecuteNonQuery gerekir. Komutu yürütme işlemi henüz tamamlanmadıysa, bu yöntem işlem tamamlanana kadar engeller. Kullanıcılar, yöntemi tarafından BeginExecuteNonQuery() döndürülen örneği kullanarak komutun IAsyncResult işlemini tamamladığını doğrulayabilir. çağrısında BeginExecuteNonQuery()bir geri çağırma yordamı belirtildiyse, bu yöntem çağrılmalıdır.