IDbCommand.ExecuteNonQuery Método

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

Ejecuta una instrucción SQL contra el objeto Connection de un proveedor de datos .NET y devuelve el número de filas afectadas.

public:
 int ExecuteNonQuery();

public int ExecuteNonQuery ();

abstract member ExecuteNonQuery : unit -> int

Public Function ExecuteNonQuery () As Integer

Devoluciones

Int32

El número de filas afectadas.

Excepciones

InvalidOperationException

La conexión no existe.

O bien

La conexión no está abierta.

Ejemplos

En el ejemplo siguiente se crea una instancia de la clase derivada, y, a continuación, OleDbCommandse ejecuta. Para ello, el método se pasa una cadena que es una instrucción SELECT de SQL y una cadena que se va a usar para conectarse al origen de datos.

static private void CreateOleDbCommand(
    string queryString, string connectionString)
{
    using (OleDbConnection connection = new
               OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbCommand command = new
            OleDbCommand(queryString, connection);
        command.ExecuteNonQuery();
    }
}

Private Sub CreateOleDbCommand( _
    ByVal queryString As String, ByVal connectionString As String)
    Using connection As New OleDbConnection(connectionString)
        connection.Open()
        Dim command As New OleDbCommand(queryString, connection)
        command.ExecuteNonQuery()
    End Using
End Sub

Comentarios

Puede usar ExecuteNonQuery para realizar operaciones de catálogo (por ejemplo, consultar la estructura de una base de datos o crear objetos de base de datos como tablas) o cambiar los datos de una base de datos sin usar mediante DataSet la ejecución de instrucciones UPDATE, INSERT o DELETE.

ExecuteNonQuery Aunque no devuelve ninguna fila, los parámetros de salida o los valores devueltos asignados a los parámetros se rellenan con datos.

Para las instrucciones UPDATE, INSERT y DELETE, el valor devuelto corresponde al número de filas afectadas por el comando. Para los demás tipos de instrucciones, el valor devuelto es -1.