IDbCommand.ExecuteNonQuery Metodo

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Esegue un'istruzione SQL sull'oggetto Connection di un provider di dati .NET e restituisce il numero di righe interessate.

public:
 int ExecuteNonQuery();

public int ExecuteNonQuery ();

abstract member ExecuteNonQuery : unit -> int

Public Function ExecuteNonQuery () As Integer

Restituisce

Int32

Numero di righe interessate.

Eccezioni

InvalidOperationException

La connessione non esiste.

-oppure-

La connessione non è aperta.

Esempio

Nell'esempio seguente viene creata un'istanza della classe derivata, OleDbCommand, e quindi la esegue. A questo scopo, il metodo viene passato una stringa che è un'istruzione SQL SELECT 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 usare per ExecuteNonQuery eseguire operazioni di catalogo, ad esempio eseguendo query sulla struttura di un database o creando oggetti di database, ad esempio tabelle, o per modificare i dati in un database senza usare 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.