OleDbCommand.ExecuteNonQuery Méthode

Définition

Espace de noms:
System.Data.OleDb
Assembly:
System.Data.dll

Exécute une instruction SQL sur l’instruction Connection et retourne le nombre de lignes affectées.

public:
 virtual int ExecuteNonQuery();
public:
 override int ExecuteNonQuery();
public int ExecuteNonQuery();
public override int ExecuteNonQuery();
abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer
Public Overrides Function ExecuteNonQuery () As Integer

Retours

Int32

Nombre de lignes affectées.

Implémente

ExecuteNonQuery()

Exceptions

InvalidOperationException

La connexion n’existe pas.

-ou-

La connexion n’est pas ouverte.

-ou-

Impossible d’exécuter une commande dans un contexte de transaction qui diffère du contexte dans lequel la connexion a été initialement inscrite.

Exemples

L’exemple suivant crée un OleDbCommand élément, puis l’exécute à l’aide ExecuteNonQueryde . L’exemple est passé une chaîne qui est une instruction SQL telle que UPDATE, INSERT ou DELETE, 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, 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 d’instructions DataSet UPDATE, INSERT ou DELETE.

Bien que les ExecuteNonQuery retours ne renvoient aucune ligne, tous les paramètres de sortie ou valeurs renvoyées mappés 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. Si une restauration se produit, la valeur de retour est également -1.

S’applique à

Voir aussi