OracleCommand.ExecuteNonQuery Metodo

Definizione

Esegue un'istruzione SQL nella proprietà Connection e restituisce il numero di righe modificate.Executes an SQL statement against the Connection and returns the number of rows affected.

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

Restituisce

Nel caso delle istruzioni UPDATE, INSERT e DELETE, il valore restituito è il numero di righe interessate dal comando.For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. Per le istruzioni CREATE TABLE e DROP TABLE, il valore restituito sarà 0.For CREATE TABLE and DROP TABLE statements, the return value is 0. Per tutti gli altri tipi di istruzioni, il valore restituito è -1.For all other types of statements, the return value is -1.

Implementazioni

Eccezioni

La connessione non esiste.The connection does not exist.

-oppure--or-

La connessione non è aperta.The connection is not open.

Esempi

Nell'esempio seguente viene creata una OracleCommand e quindi viene eseguita utilizzando ExecuteNonQuery.The following example creates an OracleCommand and then executes it by using ExecuteNonQuery. All'esempio viene passata una stringa che è un'istruzione SQL (ad esempio UPDATE, INSERT o DELETE) e una stringa da utilizzare per la connessione al database.The example is passed a string that is an SQL statement (such as UPDATE, INSERT, or DELETE) and a string to use to connect to the database.

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

Commenti

È possibile utilizzare ExecuteNonQuery per eseguire operazioni di catalogo, ad esempio l'esecuzione di query sulla struttura di un database o la creazione di oggetti di database quali tabelle. oppure per modificare i dati in un database, senza usare un DataSet, eseguendo istruzioni UPDATE, INSERT o DELETE.You can use ExecuteNonQuery to perform catalog operations (for example, querying the structure of a database or creating database objects such as tables); or to change the data in a database, without using a DataSet, by executing UPDATE, INSERT, or DELETE statements.

Anche se ExecuteNonQuery non restituisce alcuna riga, i parametri di output o i valori restituiti mappati ai parametri vengono popolati con i dati.Although ExecuteNonQuery does not return any rows, any output parameters or return values mapped to parameters are populated with data.

Nel caso delle istruzioni UPDATE, INSERT e DELETE, il valore restituito è il numero di righe interessate dal comando.For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. Per le istruzioni CREATE TABLE e DROP TABLE, il valore restituito sarà 0.For CREATE TABLE and DROP TABLE statements, the return value is 0. Per tutti gli altri tipi di istruzioni, il valore restituito è -1.For all other types of statements, the return value is -1. Se si verifica un rollback, anche il valore restituito è-1.If a rollback occurs, the return value is also -1.

Si applica a

Vedi anche