Condividi tramite


OleDbCommand.ExecuteNonQuery Metodo

Definizione

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

Numero di righe interessate.

Implementazioni

Eccezioni

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.

Si applica a

Vedi anche