Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.

Traducción

Original

Este tema aún no ha recibido ninguna valoración - Valorar este tema

SqlCommand.EndExecuteNonQuery (Método)

.NET Framework 4.5

Otras versiones

Finaliza la ejecución asincrónica de una instrucción de Transact-SQL.

Espacio de nombres: System.Data.SqlClient
Ensamblado: System.Data (en System.Data.dll)

Sintaxis

C++

public int EndExecuteNonQuery(
	IAsyncResult asyncResult
)

Parámetros

asyncResult: Tipo: System.IAsyncResult
IAsyncResult que devuelve la llamada a BeginExecuteNonQuery

Valor devuelto

Tipo: System.Int32
El número de filas afectadas (el mismo comportamiento que el de ExecuteNonQuery).

Excepciones

Excepción	Condición
ArgumentException	El valor del parámetro asyncResult es null (Nothing en Microsoft Visual Basic).
InvalidOperationException	Se ha llamado varias veces a EndExecuteNonQuery para ejecutar un solo comando o el método no coincide con el método de ejecución (por ejemplo, el código llama a EndExecuteNonQuery para finalizar la ejecución de una llamada a BeginExecuteXmlReader).
SqlException	El tiempo especificado en CommandTimeout transcurrido y la operación asincrónica especificada con BeginExecuteNonQuery no se completa. En algunas situaciones, IAsyncResult se puede establecer en IsCompleted incorrectamente. Si esto y se llama a EndExecuteNonQuery , EndExecuteNonQuery podría provocar un error de SqlException si transcurrido el tiempo especificado en CommandTimeout y la operación asincrónica especificada con BeginExecuteNonQuery no se completa. Para corregir esta situación, debe aumentar el valor de CommandTimeout o reducir el trabajo que realiza la operación asincrónica.

Excepción

Condición

ArgumentException

El valor del parámetro asyncResult es null (Nothing en Microsoft Visual Basic).

InvalidOperationException

Se ha llamado varias veces a EndExecuteNonQuery para ejecutar un solo comando o el método no coincide con el método de ejecución (por ejemplo, el código llama a EndExecuteNonQuery para finalizar la ejecución de una llamada a BeginExecuteXmlReader).

SqlException

El tiempo especificado en CommandTimeout transcurrido y la operación asincrónica especificada con BeginExecuteNonQuery no se completa.

En algunas situaciones, IAsyncResult se puede establecer en IsCompleted incorrectamente. Si esto y se llama a EndExecuteNonQuery , EndExecuteNonQuery podría provocar un error de SqlException si transcurrido el tiempo especificado en CommandTimeout y la operación asincrónica especificada con BeginExecuteNonQuery no se completa. Para corregir esta situación, debe aumentar el valor de CommandTimeout o reducir el trabajo que realiza la operación asincrónica.

Comentarios

Cuando se llama a BeginExecuteNonQuery para ejecutar una instrucción de Transact-SQL , debe llamar a EndExecuteNonQuery para completar la operación. Si aún no ha finalizado el proceso de ejecución del comando, este método se bloquea hasta que termina la operación. Los usuarios pueden comprobar si ha finalizado la ejecución del comando utilizando la instancia de IAsyncResult devuelta por el método BeginExecuteNonQuery. Si hay un procedimiento de devolución de llamada especificado en la llamada a BeginExecuteNonQuery, se debe llamar a este método.

Ejemplos

Para obtener ejemplos que muestran cómo usar el método EndExecuteNonQuery, vea BeginExecuteNonQuery.

Información de versión

.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Vea también

Referencia

SqlCommand Clase

System.Data.SqlClient (Espacio de nombres)

Otros recursos

Connecting and Retrieving Data in ADO.NET

Using the .NET Framework Data Provider for SQL Server

Proveedores administrados de ADO.NET y centro de desarrolladores de conjunto de datos

¿Te ha resultado útil? Sí No

No es preciso

No es lo suficientemente profundo

Se necesitan ejemplos de código adicionales

La traducción necesita mejoras

(Caracteres restantes: 1500)

Adiciones de comunidad

AGREGAR