OleDbCommand.ExecuteNonQuery Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Ejecuta una instrucción SQL en Connection y devuelve el número de filas afectadas.
public:
override int ExecuteNonQuery();public:
virtual int ExecuteNonQuery();public override int ExecuteNonQuery ();public int ExecuteNonQuery ();override this.ExecuteNonQuery : unit -> intabstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> intPublic Overrides Function ExecuteNonQuery () As IntegerPublic Function ExecuteNonQuery () As IntegerDevoluciones
El número de filas afectadas.
Implementaciones
Excepciones
La conexión no existe.
O bien
La conexión no está abierta.
o bien
No se puede ejecutar un comando en un contexto de transacción distinto al contexto en que se incorporó la conexión originalmente.
Ejemplos
En el ejemplo siguiente se crea y OleDbCommand , 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 DataSet mediante 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.
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. Si se produce una reversión, el valor devuelto también es -1.
