OleDbCommand.ExecuteReader Méthode

Définition

Espace de noms:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Paquet:

System.Data.OleDb v9.0.0-rc.2.24473.5

Envoie CommandText à Connection et génère OleDbDataReader.

Surcharges

ExecuteReader()	Envoie CommandText à Connection et génère OleDbDataReader.
ExecuteReader(CommandBehavior)	Envoie CommandText à Connection et génère OleDbDataReader à l'aide d'une valeur CommandBehavior.

ExecuteReader()

Source:

OleDbCommand.cs

Envoie CommandText à Connection et génère OleDbDataReader.

public:
 System::Data::OleDb::OleDbDataReader ^ ExecuteReader();

public System.Data.OleDb.OleDbDataReader ExecuteReader ();

override this.ExecuteReader : unit -> System.Data.OleDb.OleDbDataReader

Public Function ExecuteReader () As OleDbDataReader

Retours

OleDbDataReader

Objet OleDbDataReader.

Exceptions

InvalidOperationException

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 en passant une chaîne qui est une instruction SQL SELECT et une chaîne à utiliser pour se connecter à la source de données.

public void CreateReader(string connectionString, string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader[0].ToString());
        }
        reader.Close();
    }
}

Public Sub CreateReader(ByVal connectionString As String, _
    ByVal queryString As String)

    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader(0).ToString())
        End While
        reader.Close()
    End Using
End Sub

Remarques

Lorsque la propriété a la CommandTypeStoredProcedurevaleur , la CommandText propriété doit être définie sur le nom de la procédure stockée. La commande exécute cette procédure stockée lorsque vous appelez ExecuteReader.

Avant de fermer , OleDbConnectionfermez d’abord l’objet OleDbDataReader . Vous devez également fermer l’objet OleDbDataReader si vous envisagez de réutiliser un OleDbCommand objet.

Voir aussi

• Utilisation des commandes

ExecuteReader(CommandBehavior)

Source:

OleDbCommand.cs

Envoie CommandText à Connection et génère OleDbDataReader à l'aide d'une valeur CommandBehavior.

public:
 System::Data::OleDb::OleDbDataReader ^ ExecuteReader(System::Data::CommandBehavior behavior);

public System.Data.OleDb.OleDbDataReader ExecuteReader (System.Data.CommandBehavior behavior);

override this.ExecuteReader : System.Data.CommandBehavior -> System.Data.OleDb.OleDbDataReader

Public Function ExecuteReader (behavior As CommandBehavior) As OleDbDataReader

Paramètres

behavior

CommandBehavior

Une des valeurs de l'objet CommandBehavior.

Retours

OleDbDataReader

Objet OleDbDataReader.

Exceptions

InvalidOperationException

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 en passant une chaîne qui est une instruction Transact-SQL SELECT et une chaîne à utiliser pour se connecter à la source de données. CommandBehavior a la valeur CloseConnection.

public void CreateMyOleDbDataReader(string queryString,string connectionString)
{
   OleDbConnection connection = new OleDbConnection(connectionString);
   OleDbCommand command = new OleDbCommand(queryString, connection);
   connection.Open();
   OleDbDataReader reader = command.ExecuteReader(CommandBehavior.CloseConnection);
   while(reader.Read())
   {
      Console.WriteLine(reader.GetString(0));
   }
   reader.Close();
   //Implicitly closes the connection because CommandBehavior.CloseConnection was specified.
}

Public Sub CreateMyOleDbDataReader(queryString As String, _
    connectionString As String)
    Dim connection As New OleDbConnection(connectionString)
    Dim command As New OleDbCommand(queryString, connection)
    connection.Open()
    Dim reader As OleDbDataReader = command.ExecuteReader(CommandBehavior.CloseConnection)
    While reader.Read()
        Console.WriteLine(reader.GetString(0))
    End While
    reader.Close()
    'Implicitly closes the connection because CommandBehavior.CloseConnection was specified.
 End Sub

Remarques

Lorsque vous spécifiez SingleRow avec la ExecuteReader méthode de l’objet OleDbCommand , le fournisseur de données .NET Framework pour OLE DB effectue la liaison à l’aide de l’interface OLE DB IRow si elle est disponible. Sinon, il utilise l’interface IRowset . Si votre instruction SQL doit normalement retourner une seule ligne, la spécification de SingleRow peut également améliorer les performances de l'application.

Lorsque la propriété a la CommandTypeStoredProcedurevaleur , la CommandText propriété doit être définie sur le nom de la procédure stockée. La commande exécute cette procédure stockée lorsque vous appelez ExecuteReader.

Prend OleDbDataReader en charge un mode spécial qui permet de lire efficacement les valeurs binaires volumineuses. Pour plus d’informations, consultez le SequentialAccess paramètre pour CommandBehavior.

Avant de fermer , OleDbConnectionfermez d’abord l’objet OleDbDataReader . Vous devez également fermer l’objet OleDbDataReader si vous envisagez de réutiliser un OleDbCommand objet. Si est OleDbDataReader créé avec CommandBehavior défini sur CloseConnection, la fermeture de ferme automatiquement OleDbDataReader la connexion.

Voir aussi

• Utilisation des commandes