IDbCommand.ExecuteNonQuery Méthode

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Exécute une instruction SQL sur l’objet Connection d’un fournisseur de données .NET et retourne le nombre de lignes affectées.

public:
 int ExecuteNonQuery();

public int ExecuteNonQuery ();

abstract member ExecuteNonQuery : unit -> int

Public Function ExecuteNonQuery () As Integer

Retours

Int32

Nombre de lignes affectées.

Exceptions

InvalidOperationException

La connexion n’existe pas.

- ou -

La connexion n'est pas ouverte.

Exemples

L’exemple suivant crée un instance de la classe dérivée, OleDbCommand, puis l’exécute. Pour ce faire, la méthode se fait passer une chaîne qui est une instruction SQL SELECT et une chaîne à utiliser pour se connecter à la source de données.

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

Remarques

Vous pouvez utiliser pour effectuer des ExecuteNonQuery opérations de catalogue (par exemple, interroger la structure d’une base de données ou créer des objets de base de données tels que des tables) ou pour modifier les données d’une base de données sans utiliser de DataSet en exécutant des instructions UPDATE, INSERT ou DELETE.

Bien que le ExecuteNonQuery ne retourne aucune ligne, les paramètres de sortie ou valeurs de retour mappés aux paramètres sont remplis avec des données.

Pour les instructions UPDATE, INSERT et DELETE, les valeurs de retour représentent le nombre de lignes affectées par la commande. Pour tous les autres types d'instructions, la valeur de retour est -1.