OracleCommand.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:
virtual int ExecuteNonQuery();public:
override int ExecuteNonQuery();public int ExecuteNonQuery ();public override int ExecuteNonQuery ();abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> intoverride this.ExecuteNonQuery : unit -> intPublic Function ExecuteNonQuery () As IntegerPublic Overrides Function ExecuteNonQuery () As IntegerDevoluciones
Para las instrucciones UPDATE, INSERT y DELETE, el valor devuelto corresponde al número de filas afectadas por el comando. Para las instrucciones CREATE TABLE y DROP TABLE, el valor devuelto es 0. Para los demás tipos de instrucciones, el valor devuelto es -1.
Implementaciones
Excepciones
Ejemplos
En el ejemplo siguiente se crea y OracleCommand , a continuación, se ejecuta mediante ExecuteNonQuery. En 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 a la base de datos.
public void CreateOracleCommand(string myExecuteQuery, string connectionString)
{
using (OracleConnection connection = new OracleConnection(connectionString))
{
OracleCommand command = new OracleCommand(myExecuteQuery, connection);
command.Connection.Open();
command.ExecuteNonQuery();
}
}
Public Sub CreateOracleCommand(ByVal myExecuteQuery As String, _
ByVal connectionString As String)
Using connection As New OracleConnection(connectionString)
Dim command As New OracleCommand(myExecuteQuery, connection)
command.Connection.Open()
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 para cambiar los datos de una base de datos, sin usar un DataSet, ejecutando instrucciones UPDATE, INSERT o DELETE.
Aunque ExecuteNonQuery 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 las instrucciones CREATE TABLE y DROP TABLE, el valor devuelto es 0. 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.
