OleDbCommand.ExecuteNonQuery Metodo

Definizione

Spazio dei nomi:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacchetto:

System.Data.OleDb v8.0.0

Source:

OleDbCommand.cs

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

Numero di righe interessate.

Implementazioni

ExecuteNonQuery()

Eccezioni

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.

Esempio

Nell'esempio seguente viene creato un oggetto OleDbCommand 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 all'origine dati.

static private void CreateOleDbCommand(
    string queryString, string connectionString)
{
    using (OleDbConnection connection = new
               OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbCommand command = new
            OleDbCommand(queryString, connection);
        command.ExecuteNonQuery();
    }
}

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

Commenti

È possibile utilizzare per ExecuteNonQuery eseguire operazioni di catalogo, ad esempio, per eseguire query sulla struttura di un database o per creare oggetti di database come tabelle o per modificare i dati in un database senza utilizzare un'istruzione DataSet UPDATE, INSERT o DELETE.

Anche se non ExecuteNonQuery 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 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