OleDbCommand.ExecuteNonQuery Metodo

Definizione

Spazio dei nomi:
System.Data.OleDb
Assembly:
System.Data.dll

Esegue un'istruzione SQL su Connection e restituisce il numero di righe interessate.

public:
 virtual int ExecuteNonQuery();
public:
 override int ExecuteNonQuery();
public int ExecuteNonQuery();
public override int ExecuteNonQuery();
abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer
Public Overrides Function ExecuteNonQuery () As Integer

Valori restituiti

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 diverso dal contesto in cui è stata originariamente inserita la connessione.

Esempio

Nell'esempio seguente viene creato un oggetto OleDbCommand e quindi 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 ExecuteNonQuery per 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.

Per le 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, il valore restituito è anche -1.

Si applica a

Vedi anche