OleDbCommand, classe
Mise à jour : novembre 2007
Représente une instruction SQL ou une procédure stockée à exécuter par rapport à une source de données.
Assembly : System.Data (dans System.Data.dll)
Lorsqu'une instance de OleDbCommand est créée, les propriétés de lecture/écriture prennent leurs valeurs initiales. Pour obtenir la liste de ces valeurs, consultez le constructeur OleDbCommand.
OleDbCommand met en œuvre les méthodes suivantes exécutant des commandes au niveau d'une source de données :
|
Élément |
Description |
|---|---|
|
Exécute des commandes qui retournent des lignes. Il se peut que ExecuteReader n'ait pas l'effet souhaité s'il est utilisé pour exécuter des commandes, telles que des instructions SQL SET. |
|
|
Exécute des commandes, telles que des instructions SQL INSERT, DELETE, UPDATE et SET. |
|
|
Récupère une valeur unique (par exemple, une valeur d'agrégation) d'une base de données. |
Vous pouvez réinitialiser la propriété CommandText et réutiliser l'objet OleDbCommand. Cependant, vous devez fermer OleDbDataReader avant d'exécuter une commande nouvelle ou précédente.
Si un OleDbException irrécupérable (par exemple, un niveau de gravité SQL Server de 20 ou plus) est généré par la méthode exécutant OleDbCommand, OleDbConnection, la connexion peut être fermée. L'utilisateur peut toutefois rouvrir la connexion et continuer.
L'exemple suivant utilise OleDbCommand, ainsi que OleDbDataAdapter et OleDbConnection pour sélectionner des lignes à partir d'une base de données Access. Le DataSet rempli est ensuite retourné. Un DataSet initialisé, une chaîne de connexion, une chaîne de requête qui est une instruction SQL SELECT et une chaîne qui est le nom de la table de base de données source sont passés à l'exemple.
public void ReadMyData(string connectionString) { string queryString = "SELECT OrderID, CustomerID FROM Orders"; using (OleDbConnection connection = new OleDbConnection(connectionString)) { OleDbCommand command = new OleDbCommand(queryString, connection); connection.Open(); OleDbDataReader reader = command.ExecuteReader(); while (reader.Read()) { Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1)); } // always call Close when done reading. reader.Close(); } }
System.MarshalByRefObject
System.ComponentModel.Component
System.Data.Common.DbCommand
System.Data.OleDb.OleDbCommand
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.