OleDbCommand.ExecuteNonQuery Método

Definición

Espacio de nombres:
System.Data.OleDb
Ensamblado:
System.Data.dll

Ejecuta una instrucción SQL en y Connection devuelve el número de filas afectadas.

public:
 virtual int ExecuteNonQuery();
public:
 override int ExecuteNonQuery();
public int ExecuteNonQuery();
public override int ExecuteNonQuery();
abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer
Public Overrides Function ExecuteNonQuery () As Integer

Devoluciones

Int32

Número de filas afectadas.

Implementaciones

ExecuteNonQuery()

Excepciones

InvalidOperationException

La conexión no existe.

O bien

La conexión no está abierta.

O bien

No se puede ejecutar un comando dentro de un contexto de transacción que difiere del contexto en el que se inscribe originalmente la conexión.

Ejemplos

En el ejemplo siguiente se crea OleDbCommand y, a continuación, se ejecuta mediante ExecuteNonQuery. El ejemplo se pasa una cadena que es una instrucción SQL, como UPDATE, INSERT o DELETE, 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, para consultar la estructura de una base de datos o para crear objetos de base de datos como tablas, o para cambiar los datos de una base de datos sin usar mediante DataSet la ejecución de instrucciones UPDATE, INSERT o DELETE.

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

En el caso de las instrucciones UPDATE, INSERT y DELETE, el valor devuelto es el número de filas afectadas por el comando. Para todos los demás tipos de instrucciones, el valor devuelto es -1. Si se produce una reversión, el valor devuelto también es -1.

Se aplica a

Consulte también