IDbCommand.ExecuteNonQuery Metodo

Definizione

Spazio dei nomi:
System.Data
Assembly:
System.Data.dll
Assembly:
netstandard.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

Valori restituiti

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 , OleDbCommande quindi viene eseguita. A tale scopo, al metodo viene passata 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 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, oppure per modificare i dati in un database senza utilizzare un DataSet oggetto eseguendo istruzioni UPDATE, INSERT o DELETE.

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

Si applica a