OracleCommand.ExecuteNonQuery Metodo

Definizione

Spazio dei nomi:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Esegue un'istruzione SQL nella proprietà Connection e restituisce il numero di righe modificate.

public:
 override int ExecuteNonQuery();

public override int ExecuteNonQuery ();

override this.ExecuteNonQuery : unit -> int

Public Overrides Function ExecuteNonQuery () As Integer

Restituisce

Int32

Nel caso delle istruzioni UPDATE, INSERT e DELETE, il valore restituito è il numero di righe interessate dal comando. Per le istruzioni CREATE TABLE e DROP TABLE, il valore restituito sarà 0. Per tutti gli altri tipi di istruzioni, il valore restituito è -1.

Eccezioni

InvalidOperationException

La connessione non esiste.

-oppure-

La connessione non è aperta.

Esempio

Nell'esempio seguente viene creato un oggetto OracleCommand e quindi viene eseguito usando ExecuteNonQuery. Nell'esempio viene passata una stringa che è un'istruzione SQL , ad esempio UPDATE, INSERT o DELETE, e una stringa da usare per connettersi al 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 per eseguire query sulla struttura di un database o per creare oggetti di database, ad esempio tabelle, oppure per modificare i dati in un database, senza utilizzare un DataSet, eseguendo istruzioni UPDATE, INSERT o DELETE.

Anche se ExecuteNonQuery non restituisce righe, i parametri di output o i valori restituiti mappati ai parametri vengono popolati con i dati.

Nel caso delle istruzioni UPDATE, INSERT e DELETE, il valore restituito è il numero di righe interessate dal comando. Per le istruzioni CREATE TABLE e DROP TABLE, il valore restituito sarà 0. Per tutti gli altri tipi di istruzioni, il valore restituito è -1. Se si verifica un rollback, anche il valore restituito è -1.

Vedi anche

• Uso dei comandi