Ce sujet n'a pas encore été évalué - Évaluez ce sujet

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.

Espace de noms :  System.Data.OleDb
Assembly :  System.Data (dans System.Data.dll)

public sealed class OleDbCommand : DbCommand, 
	ICloneable, IDbCommand, IDisposable
public final class OleDbCommand extends DbCommand implements ICloneable, 
	IDbCommand, IDisposable
public final class OleDbCommand extends DbCommand implements ICloneable, IDbCommand, IDisposable

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

ExecuteReader

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.

ExecuteNonQuery

Exécute des commandes, telles que des instructions SQL INSERT, DELETE, UPDATE et SET.

ExecuteScalar

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();
    }
}


Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

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.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,