Esegue un'istruzione SQL nella proprietà
Connection e restituisce il numero di righe modificate.
Spazio dei nomi: System.Data.OleDb
Assembly: System.Data (in system.data.dll)
Visual Basic - (Dichiarazione)
Public Overrides Function ExecuteNonQuery As Integer
Dim instance As OleDbCommand
Dim returnValue As Integer
returnValue = instance.ExecuteNonQuery
public override int ExecuteNonQuery ()
public:
virtual int ExecuteNonQuery () override
public int ExecuteNonQuery ()
public override function ExecuteNonQuery () : int
Valore restituito
Numero di righe interessate.
| Tipo di eccezione | Condizione |
|---|
InvalidOperationException | La connessione non esiste. -oppure- La connessione non è aperta. -oppure- Impossibile eseguire un comando all'interno di un contesto di transazione differente da quello in cui la connessione è stata in origine inserita. |
È possibile utilizzare il metodo ExecuteNonQuery per eseguire operazioni di catalogo, ad esempio eseguire query sulla struttura di un database o creare oggetti del database quali tabelle, oppure modificare i dati contenuti in un database senza utilizzare una classe DataSet, eseguendo le istruzioni UPDATE, INSERT o DELETE.
Sebbene il metodo ExecuteNonQuery non restituisca alcuna riga, gli eventuali parametri di output o valori restituiti di cui è stato eseguito il mapping a parametri dispongono di 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. Anche se si verifica un'operazione di rollback, il valore restituito sarà -1.
Nell'esempio riportato di seguito viene creata una classe OleDbCommand che viene quindi eseguita mediante il metodo ExecuteNonQuery. All'esempio viene passata una stringa che rappresenta un'istruzione SQL, come UPDATE, INSERT o DELETE, e una stringa da utilizzare per la connessione all'origine dati.
Private Sub CreateOleDbCommand( _
ByVal queryString As String, ByVal connectionString As String)
Using connection As New OleDbConnection(connectionString)
connection.Open()
Dim command As New OleDbCommand(queryString, connection)
command.ExecuteNonQuery()
End Using
End Sub
static private void CreateOleDbCommand(
string queryString, string connectionString)
{
using (OleDbConnection connection = new
OleDbConnection(connectionString))
{
connection.Open();
OleDbCommand command = new
OleDbCommand(queryString, connection);
command.ExecuteNonQuery();
}
}
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.
Informazioni sulla versione
.NET Framework
Supportato in: 2.0 1.1 1.0