IDbCommand.ExecuteNonQuery Méthode

Définition

Espace de noms:

System.Data

Assembly:

System.Data.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 une instance de la classe dérivée, OleDbCommandpuis l’exécute. Pour ce faire, la méthode est passée à 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 les 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 modifier les données d’une base de données sans utiliser d’instructions DataSet UPDATE, INSERT ou DELETE.

Bien que les ExecuteNonQuery lignes ne retournent aucune ligne, les paramètres de sortie ou les valeurs renvoyées mappées aux paramètres sont renseignés avec des données.

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