IDbCommand.ExecuteNonQuery Méthode

Définition

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

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,, puis l' OleDbCommand exécute. pour ce faire, la méthode reçoit 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 le ExecuteNonQuery pour effectuer des opérations de catalogue (par exemple, pour interroger la structure d’une base de données ou pour 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 une DataSet en exécutant des instructions Update, INSERT ou DELETE.

Bien que ExecuteNonQuery ne retourne pas de lignes, les paramètres de sortie ou les 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.

S’applique à