OdbcCommand.ExecuteNonQuery Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Data.Odbc
Assembly:
System.Data.Odbc.dll
Assembly:
System.Data.dll
Pacchetto:
System.Data.Odbc v6.0.0
Pacchetto:
System.Data.Odbc v7.0.0
Pacchetto:
System.Data.Odbc v8.0.0
Pacchetto:
System.Data.Odbc v9.0.0-preview.2.24128.5
Source:
OdbcCommand.cs
Source:
OdbcCommand.cs
Source:
OdbcCommand.cs

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

public:
 override int ExecuteNonQuery();
public:
 virtual int ExecuteNonQuery();
public override int ExecuteNonQuery ();
public int ExecuteNonQuery ();
override this.ExecuteNonQuery : unit -> int
abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
Public Overrides Function ExecuteNonQuery () As Integer
Public 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 tutti gli altri tipi di istruzioni, il valore restituito è -1.

Implementazioni

ExecuteNonQuery()

Eccezioni

InvalidOperationException

La connessione non esiste.

-oppure-

La connessione non è aperta.

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 possibile usare ExecuteNonQuery per eseguire più istruzioni SQL se il driver ODBC sottostante supporta questa funzionalità. In questo caso, il valore restituito è il numero di righe interessate da tutte le istruzioni nel comando.

Sebbene ExecuteNonQuery non restituisca alcuna riga, 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 tutti gli altri tipi di istruzioni, il valore restituito è -1. Se si verifica un rollback, anche il valore restituito è -1.

Quando un trigger esiste in una tabella e i dati vengono aggiunti o modificati nella tabella, il valore restituito include il numero di righe interessate dall'operazione di inserimento o aggiornamento e dal numero di righe interessate dal trigger o dai trigger.

Si applica a

Vedi anche