OracleCommand.ExecuteNonQuery OracleCommand.ExecuteNonQuery OracleCommand.ExecuteNonQuery OracleCommand.ExecuteNonQuery Method

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:
 override int ExecuteNonQuery();
public override int ExecuteNonQuery ();
override this.ExecuteNonQuery : unit -> int
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.

Eccezioni

La connessione non esiste.The connection does not exist.

In alternativa-or-

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

Esempi

L'esempio seguente crea un OracleCommand che viene eseguita usando ExecuteNonQuery.The following example creates an OracleCommand and then executes it by using ExecuteNonQuery. Nell'esempio viene passata una stringa che rappresenta un'istruzione SQL (ad esempio UPDATE, INSERT o DELETE) e una stringa da usare per connettersi 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 usare ExecuteNonQuery per eseguire operazioni di catalogo (ad esempio, eseguire query sulla struttura di un database o la creazione di oggetti di database quali tabelle); o per modificare i dati in un database, senza utilizzare un DataSet, per l'esecuzione di UPDATE, INSERT o eliminare istruzioni.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.

Sebbene ExecuteNonQuery non restituito da tutte le righe, gli eventuali parametri di output o i valori 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'operazione di rollback, anche il valore restituito è -1.If a rollback occurs, the return value is also -1.

Si applica a

Vedi anche