OleDbCommand.ExecuteNonQuery Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Exécute une instruction SQL sur Connection et retourne le nombre de lignes affectées.
public:
override int ExecuteNonQuery();public:
virtual int ExecuteNonQuery();public override int ExecuteNonQuery ();public int ExecuteNonQuery ();override this.ExecuteNonQuery : unit -> intabstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> intPublic Overrides Function ExecuteNonQuery () As IntegerPublic Function ExecuteNonQuery () As IntegerRetours
Nombre de lignes affectées.
Implémente
Exceptions
La connexion n’existe pas.
- ou -
La connexion n'est pas ouverte.
- ou -
Impossible d'exécuter une commande au sein d'un contexte de transaction différent de celui dans lequel la connexion a été inscrite à l'origine.
Exemples
L’exemple suivant crée un OleDbCommand , puis l’exécute à l’aide ExecuteNonQueryde . L’exemple est transmis à 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 pour effectuer des 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 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. Si une restauration se produit, la valeur de retour est également -1.
