OracleCommand.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:
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
Pour les instructions UPDATE, INSERT et DELETE, les valeurs de retour représentent le nombre de lignes affectées par la commande. Pour les instructions CREATE TABLE et DROP TABLE, la valeur de retour est 0. Pour tous les autres types d'instructions, la valeur de retour est -1.
Implémente
Exceptions
Exemples
L’exemple suivant crée un OracleCommand , 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 base de données.
public void CreateOracleCommand(string myExecuteQuery, string connectionString)
{
using (OracleConnection connection = new OracleConnection(connectionString))
{
OracleCommand command = new OracleCommand(myExecuteQuery, connection);
command.Connection.Open();
command.ExecuteNonQuery();
}
}
Public Sub CreateOracleCommand(ByVal myExecuteQuery As String, _
ByVal connectionString As String)
Using connection As New OracleConnection(connectionString)
Dim command As New OracleCommand(myExecuteQuery, connection)
command.Connection.Open()
command.ExecuteNonQuery()
End Using
End Sub
Remarques
Vous pouvez utiliser ExecuteNonQuery pour effectuer des 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 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 les instructions CREATE TABLE et DROP TABLE, la valeur de retour est 0. 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.